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WHY BUY MANUAL? 


• ECONOMICAL 

(MINIMUM I CAN BUY THE CAR WITH) 

(I CAN SAVE ON GAS. IF I DON'T ABUSE IT) 

(I DON'T NEED A BATTERY TO START THE CAR) 

• PERFORMANCE 

(I AM A RACE CAR DRIVER) 

(TERRAIN CALLS FOR IT. MOUNTAINOUS. HILLS. .. .ETC. ) 

t- ^ / 


• DISADVANTAGE 

(NEED A SKILLED DRIVER) 

(HAVE TO DO MORE WORK) 

(CAN'T HOLD ON TO "PERSON" FRIEND WHILE DRIVING) 


WHY BUY AUTOMATIC? 

• LAZY 

(LESS WORK. NO PUSHING CLUTCH. NO CHANGING GEARS) 

• SKILL 

(DON'T NEED TO WORRY ABOUT ROLLING DOWN HILLS) 

\ / 

• DISADVANTAGE 

(COSTS MORE) 
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CHAPTER 1 

RMX 86 BASIC I/O SYSTEMS 

-An Applications Programmer's View 

• FILES 

• FILE CLASSES 

MANUAL 

• I/O OPERATIONS 

• HIERARCHICAL FILE STRUCTURES 



• FILE CONNECTION 



PROGRAMMING ROLES 


THERE ARE TWO PROGRAMMING ROLES ASSOCIATED WITH 
THE IRMX 86 OPERATING SYSTEM. 

- THE APPLICATION PROGRAMMER USES SYSTEM CALLS 
AND OBJECTS THAT AFFECT ONLY HIS OWN JOB 
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COMMUNICATION 


• TASKS MAKE "SYSTEM CALLS" TO THE BIOS TO COMMUNICATE 
WITH THE FILE 
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• STREAM FILE 



CLASSES OF FILES 


§ PHYSICAL FILE - CONTINUOUS SEQUENCE OF BYTES ON A DEVICE WHERE NO 
FILE STRUCTURE IS IMPOSED (E.G.. PRINTER. TERMINAL) 


• NAMED FILE 


MEMORY BASED BYTE STREAMS. DESTRUCTIVE-READ 
SERVES COMMUNICATION BETWEEN TASKS 


DATA FILES RESIDING ON RANDOM ACCESS STORAGE DEVICES, 
ACCESSED VIA ASCII NAMES (E.G.. FLOPPY DISK. HARD 
DISK). 
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OPEN 




AFTER A FILE CONNECTION HAS BEEN ESTABLISHED. THE RQ$A$OPEN' 
SYSTEM CALL OPENS A FILE FOR I/O OPERATIONS 

• OPEN FILE COMMANDS 
READ 
WRITE 
SEEK 



f THE RQ$A$OPEN SPECIFIES 

- A FILE MAY BE 

READ ONLY 
WRITE ONLY 
READ OR WRITE 

- TYPE OF SHARING DESIRED 

READERS 

WRITERS 

ALL 
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CALL RQ$A$OPEN (FILE$CONNECTION$TOKEN> MODE. SHARE. RESP$MBOX.aSTATUS; 


MODE OF ACCESS DESIRED 


OPEN FOR READING 
OPEN FOR WRITING 
OPEN FOR READING AND WRITING 


KIND OF SHARING DESIRED 


PRIVATE USE ONLY 
SHARE WITH READERS ONLY 
SHARE WITH WRITERS ONLY 
SHARE WITH ALL USERS 



THE RQ$A$READ SYSTEM CALL 


• READ 'COUNT' BYTES FROM AN OPEN FILE INTO THE BUFFER 


• BYTES ARE READ STARTING AT FILE POINTER 



CALL RQ$A$READ (FILE$CONNECTION$TOKEN. aBUFFER. COUNT. RSP$MBOX. aSTATUS)j 








THE RQ$A$SEEK SYSTEM CALL 

• MOVES THE FILE POINTER TO ANY BYTE POSITION IN THE OPEN FILE 

• HI$PTR$MOVE. LOW$PTR$MOVE = WORD PAIR CONTAINING A 32-BIT 
UNSIGNED NUMBER 


CALL RQ$SEEK (FILE$CONNECTION$TOKEN.MODE.PTR$MOVE.RESP$MBOX>aSTATUS), 


MODE ACTION BY POINTER 


BACKWARD BY PTR$MOVE (RELATIVE 
: EQUAL TO PTRIMOVE (ABSOLUTE) 

i FORWARD BY PTR$MOVE (RELATIVE) 

TO EOF MINUS PTR$MOVE (ABSOLUTE) 
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BIOS I/O ASYNCHRONOUS 

• EACH I/O OPERATION (OPEN. READ. WRITE. SEEK. CLOSE) SHOULD BE 
FOLLOWED BY A "STATUS CHECK",(HANDSHAKE) 

BASIC I/O 


^ (lORS) 

► 

(lORS) 

— ^ 

^ (lORS) 


-• (lORS) 





TASK 

OPEN 

RECEIVE 

READ 

RECEIVE 

SEEK 

RECEIVE 

READ 

RECEIVE 
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RESULT OF I/O OPERATION CALLS 


• THE PROGRAM MAY RECEIVE AN I/O RESULT SEGMENT* (lORS) 

AFTER A FILE ACCESS CALL. 

*SEE BASIC I/O REFERENCE MANUAL FOR A DESCRIPTION OF 
THE lORS STRUCTURE. 

• THE PROGRAM WAITS AT THE RESPONSE MAILBOX SPECIFIED 
IN THE CALL. 

• AFTER EXAMINING THE STATUS FIELD IN THE lORS THE PROGRAMMER 
MUST DELETE THE SEGMENT. 

• IF THE RESPONSE MAILBOX PARAMETER IN THE CALL EQUALS 0 

THEN NO lORS WILL BE RETURNED BY THE I/O SYSTEM. (NOT RECOMMENDED) 
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EXAMPLE ACCESS CALL 

CALL RQ$A$READ (FILE$CONNECTION$TOKEN, aBUFFER. 80. RSPIMBOX. aSTATUS); 
IF STATUS <>E$OK THEN CALL ERROR; /’SYNCHRONOUS PART*/ 

OVERLAPPED PROCESSING 

IORS$TOKEN = RQ$RECEIVE$MESSAGE (RSPIMBOX .aSTATUS); 

IF STATUSOEIOK THEN CALL ERROR; /’SYNCHRONOUS PART*/ 

IF IORS.STATUSOE$OK THEN CALL ERROR: /’ASYNCHRONOUS PART*/ 

CALL RQ$DELETE$SEGMENT (IORS$TOKEN.aSTATUS); 

L 




THE EASY WAY! 


• FOR MAD^ write , and SEEK WE MAY USE THE RQ$WAIT$I0 SYSTEM CALL 

• THE FORM OF THE CALL IS 


ACTUAL = RQ$WAIT$IO(CONN$T.RSPMBOX.TIMELIMIT.aSTATUS), 


• BASIC I/O DEALS WITH lORS'S DIRECTLY 

- EFFICIENT BECAUST IT KEEPS A SUPPLY OF lORS'S AVAILABLE 

- USER TASKS DO NOT HAVE TO DELETE THE lORS 
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FILE ATTACH 

• IF THE FILE ALREADY EXISTS THEN THE USER MAKES AN "ATTACH$FILE" 
SYSTEM CALL. 


CALL RQ$A$ATTACH$FILE (USER$TOKEN. PREFIX. SUBPATH. . . ..aSTATUS). 


SEE BASIC I/O REFERENCE MANUAL FOR DETAILS. 


CALL RQ$A$ATTACH$FILE (USER$OBJECT. DEVICE$CONNECTION$TOKEN. 
a(25. 'SERVICE/TUNEUP/TUNESCHED'). RSP$M,BOX. aSTATUS); 


• THE USER$TOKEN WILL BE DISCUSSED IN NEXT CHAPTER. 
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PATHNAMES 


• PATHNAMES ARE SPECIFIED BY A PREFIX AND A SUBPATH 

PREFIX - TOKEN FOR AN EXISTING DEVICE CONNECTION OR FILE CONNECTION 
- SPECIFIES THE STARTING POINT IN A DIRECTORY TREE SCAN 

SUBPATH - ASCII STRING DESIGNATING THE REST OF THE PATH 

E.G. - PREFIX DEVICE$CONNECTION$TOKEN 

-SUBPATH a(25> 'SERVICE/TUNEUPS/TUNESCHED') 

V 


FILE CREATION 

• TO CREATE A FILE THE USER MAKES A "CREATE$FILE" SYSTEM CALL 

[ CALL RQ$A$CREATE$FILE (USER$TOKE N. PREFIX. SUBPATH. . ■ SSTATUS)j 
SEE BASIC I/O REFERENCE MANUAL FOR DETAILS DN PARAMETERS 
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RESULT OF FILE CONNECTION 

• THE PROGRAMMER MUST WAIT AT THE RESONSE MAILBOX SPECIFIED IN THE 
CREATE$FILE OR ATTACH$FILE SYSTEM CALL. 



FILE$CONNECTION$TOKEN = RQ$RECEIVE$MESSAGE (RSP$MBOX. . . aSTATUS), 


• SUCCESSFUL CONNECTION RETURNS FILE CONNECTION TOKEN (TYPE = 101H) 
t UNSUCCESSFUL CONNECTION RETURNS SEGMENT TOKEN (TYPE = 6) 

- THE SEGMENT RETURNED IS AN lORS 

- THE PROGRAMMER MUST DELETE THE lORS AFTER EXAMINING THE STATUS FIELD 



EXERCISE (OPEN MANUAL) 


• HOW LONG CAN AN ASCII NAME IN A SUBPATH BE? 


• DESCRIBE PICTORIALLY AN lORS. 


• FILL IN THE ELLIPSES: 



f A PREFIX CAN BE A 
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CHAPTER 2 

RMX 86 BASIC I/O SYSTEM 

“A System Programmer's View 

f DEVICE CONNECTION 

• PHYSICAL ATTACHMENT 

• USER OBJECT 

• FILE ACCESS LIST 

J 


• SUMMARY 





1 

LAYERS 

• THE BASIC I/O SYSTEM HAS TWO LAYERS OF SOFTWARE MODULES 
SUPPLIED BY INTEL: 

- FILE DRIVER INTERFACE 

- DEVICE DRIVER INTERFACE 
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PHYSICAL ATTACHMENT 


• AT RUN TIME THE FILE DRIVER IS "PHYSICALLY ATTACHED" TO THE 


DEVICE DRIVERS THROUGH I/O SYSTEM CALLS 


PHYSICAL 





FILE DRIVERS 


WINCHESTER 



MORE ] 
DEVICE ' 

drivers! 







PHYSICAL ATTACHMENT 


CALL RQ$A$PHYSICAL$ATTACH$DEVICE (DRV$NAME> FILE$DRIVER. RESP$MBOX. aSTATUS). 


• A SUCCESSFUL "PHYSICAL ATTACH DEVICE" RETURNS A DEVICE CONNECTION 
TOKEN (TYPE = 101H) 

• AN UNSUCCESSFUL CONNECTION RETURNS A SEGMENT TOKEN (TYPE = 6) 

- THE STRUCTURE OF THE SECMENT IS AN I/O REQUEST/RESULT SEGMENT 
(lORS) 



EXAMPLE 


CALL RQ$A$PHYSICAL$ATTACH$DEVICEO(2. 'F0'), A.RESP$MBOX.aSTATUS); 

• <OVERUPPED PROCESSING MAY OCCUR HERE) 

DEVICE$CONNECTION$TOKEN = RQ$RECEIVE$MESSA6E(RESP$MBOX.efFFFFH, aRESP, aSTATUS), 
/* TEST FOR VALID CONNECTION OBJECT V 


TYPE$TOKEN = RQ$GET$TYPE(DEVICE$CONNECTION$TOKEN, aSTATUS); 
IF TYPESTOKEN < > lOlH THEN ERROR; 
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BASIC I/O SYSTEM CALLS FOR FILES 


SYSTEM 

PROGRAMMER 


- CREATEIUSER 



APPLICATION 

PROGRAMMER 


CREATE$FILE OR ATTACH$FILE 
OPEN 
READ 
SEEK } 

WRITE • ACCESS 
CLOSE 

DELETE$CONNECTION OR 
DELETE$FILE * 


PHYSICAL$DETACH$DEVICE 

DELETE$USER 


2 -; 


BASIC I/O EXERCISE 


1) WRITE THE CODE NECESSARY TO WRITE A STRING OF DATA TO A FILE 
ON A SBC204 SD/SS FLOPPY 

* GIVEN 

- THE FLOPPY HAS ALREADY BEEN FORMATTED 

- THE NAME OF THE DEVICE IS F0 

- THE NAME OF THE FILE IS 'COMPANY/EMPLOYEE/PERSONAL' 

- THE FILE ALREADY EXISTS 

- THE DATA TO BE WRITTEN AT THE END OF THE FILE 

- THE DATA IS 'L. JONES. 5050 MAIN DRAG. 3710217' 
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— 

THE USER ID STRUCTURE 

• IDENTIFYING INFORMATION ABOUT A USER (JOB OR HUMAN) 

• EACH ID$STRUCTURE CONTAINS AN ARRAY OF 16 BIT VALUES CALLED ID'S 

• THE FIRST ID IN THE ARRAY IS CALLED THE OWNER ID 


• THE REMAINING ID'S DEFINE THE GROUPS OF WHICH THE USER IS A MEMBER OF 
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USER TOKEN CREATION 


• TO CREATE A USER TOKEN THE "SYSTEM PROGRAMMER" MAKES A CALL 
TO THE O.S. IN THE FORM 


USER$TOKEN = RQ$CREATE$USER (aID$STRUCT. aSTATUS); 


• E.G. 

DECLARE ID$STRUCT STRUCTURE (LENGTH WORD. ' 

COUNT WORD. 
ID(*) WORD); 
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FILE ACCESS LIST 

• A COLLECTION OF UP TO 3 PAIRS OF OWNER ID'S AND ACCESS MASKS 

• THE ID'S REPRESENT USERS OR GROUP OF USERS 

• THE ACCESS MASK REPRESENTS THE KINDS OF ACCESS TO THE FILE 
THAT THOSE USERS OR GROUPS OF USERS ARE ALLOWED 

ACCESS 
LIST 

• THE ACCESS LIST BELONGS TO THE FILE 

L 
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ACCESS LIST CREATION 




• TASKS CALLING CREATEIFILE PASS AN ACCESS MASK AND A USER$TOKEN 

• THE I/O SYSTEM PAIRS THE "OWNER ID" AND "ACCESS MASK" AND 
APPENDS THE PAIR TO THE FILE ACCESS LIST 



• ACCESS IS ALSO IMBEDDED IN THE FILE CONNECTION TOKEN RETURNED 
TO THE CALLING TASK VIA THE RESPONSE MAILBOX 


V ^ 
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ADDING ID'S TO THE ACCESS LIST 

• THE RQ$A$CHANGE$ACCESS SYSTEM CALL WILL CHANGE THE ACCESS 
RIGHTS TO A NAMED DATA OR DIRECTORY FILE. 

• THE ID AND ACCESS SPECIFIED IN THE CALL WILL BE ADDED 
TO THE ACCESS LIST IF THE ID IS NOT FOUND IN THE LIST. 

t THE FORM OF THE CALL IS 

CALL RQ$A$CHANGE$ACCESS (USER$TOKEN. . . . .ID. ACCESS.. . . ) 






COMPUTATION OF ACCESS DURING ATTACH FILE 


• THE I/O SYSTEM COMPARES THE ID'S IN THE USER ID STRUCTURE 
WITH THE ID'S IN THE ACCESS LIST. 

• THE ACCESS MASKS CORRESPONDING TO MATCHING ID'S ARE LOGICALLY 
COMBINED. FORMING AN AGGREGARE MASK WITH COMBINED RIGHTS. 


USER ID STRUCTURE 


ACCESS LIST 



READ OR WRITE 



0 THE COMPUTED ACCESS IS IMBEDDED IN THE FILE CONNECTION TOKEN 
RETURNED TO THE CALLING TASK VIA THE RESPONSE MAILBOX. 
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LABS 



******* lab one fBASIC 10 SYSTEM) ******* 


OBJECTIVES: 

EXECUTE A STUDENT BASIC 10 APPLICATION JOB IN AN RMX86 O.S. ENVIROMENT 

INTRODUCE (BIOS) SYSTEM CALLS: 

- RQ$A$PHYSICALSATTACH$DEVICE 

- RQ$A$CREATE$FILE 

- RQ$A$OPEN 

- RQ$A$READ 

- RQ$A$SEEK 

- RQSASWRITE 

- RQSASCLOSE 

- RQSWAITSIO 

CREATE SOURCE CODE: 

- A SOURCE FILE NAMED START. P86 

- A SOURCE FILE NAMED BIOLAB. P86 

COMPILE (PLM86), LINK, AND LOCATE AN APPLICATION JOB, THAT WILL CALL UPON 
THE BIOS TO COMMUNICATE WITH A TERMINAL AND A FILE IN A FLOPPY 

STEPl: 

USE THE ATTACHSFILE COMMAND TO AHACH THE DIRECTORY NAMED (/"TEAM NAME'VLABl) 
AS THE LOGICAL NAME (:LAB:) 

- AFILE /"TEAM NAME'VLABl AS :LAB: 

* FOR THE REST OF THIS LAB WE WILL USE THIS LOGICAL NAME * 

LAB 1 



• The student will be given the nucleus, BIOS and SOB 
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******* LAB ONE (BASIC 10 SYSTEM) ******* 


STEP2: 

MODIFY A SOURCE FILE (PARTIALLY SUPPLIED FOR YOU) NAMED :LAB:BI0LAB.P86 
WITH THE "ALTER" TEXT EDITOR 

- ALTER :LAB;BI0LAB.P86 

* THIS SOURCE FILE IS THE APPLICATION TASK THAT CONFORMS TO THE FOLLOWING 
FLOWCHART 

CREATE A BUFFER */* LENGTH=80 


CREATE A RESPONSE MAILBOX */* FIFO , HIGH PERFORMANCE 


PHYSICAL ATTACH TO DEVICE */* 0(2, 'TO') , PHYSICAL , *N0TE1 


PHYSICAL ATTACH TO DEVICE */* 0(5,'WFDD0') , NAMED , *N0TE1 


CREATE FILE CONNECTION TO TERMINAL */* *N0TE1 


CREATE A USER TOKEN */* IDS=f 2,2,OOOOH,OFFFFH) 


CREATE FILE- CONNECTION TO FLOPPY */* 0r8, 'LABIDATA' ) , *N0TE1 


OPEN TERMINAL FILE */* (R/W) , SHARE ALL , *N0TE2 


OPEN FLOPPY FILE */* (R/W) , SHARE ALL , *N0TE2 


WRITE READY MESSAGE TO TERMINAL */* (USE RQ$WAIT$IO) 


•ACTUAL = 80; 


DO WHILE ACTUAL GREATER THAN 2 


READ FROM TERMINAL */* fUSE RQ$WAIT$IO) 


WRITE TO FLOPPY */* (USE RQ$WAIT$IO) 


SEEK TO EOF MINUS ACTUAL */* fUSE RQ$WAIT$IO) 


READ FROM FLOPPY */* (USE RQ$WAIT$IO) 


WRITE TO TERMINAL */* (USE RQ$WAIT$IO) 


CLOSE TERMINAL FILE */* *N0TE2 


CLOSE FLOPPY FILE */* *N0TE2 


** DELETE SELF ** 


*N0TE1: WAIT FOR CONNECTION AND VALIDATE 

*N0TE2: WAIT FOR lORS , VALIDATE lORS. STATUS , AND DELETE SEGMENT 

THE SOURCE CODE SUPPLIED DOES NOT VALIDATE CONNECTIONS OR lORS'S 
THE STUDENT MAY WISH TO IMPLEMENT THIS FUNCTIONALITY WHEN MODIFYING 
THE SOURCE CODE 
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******* LAB ONE (BASIC 10 SYSTEM) ******* 

STEPS: 

* ROOT JOBS ABSOLUTELY ADDRESS THE STARTING LOCATION OF THE STUDENT'S 
JOB CODE. THE ENTRY POINT MAY VARY IF INTERNAL PROCEDURES OR 
CHARACTER CONSTANTS ARE USED. 

FOR THIS REASON IT IS ADVISABLE TO CREATE AND LINK A START TASK TO 
THE REST OF THE APPLICATION CODE TO FIX THE ENTRY POINT'S OFFSET 
INTO THE CODE 

* THIS APPLICATION JOB WILL BE A FIRST LEVEL JOB, THIS REQUIRES 
THAT A TASK WITHIN THIS JOB MAKE A CALL TO RQ$END$INIT$TASK 
TO RESUME THE ROOT TASK 

* IN ORDER TO DEBUG OUR CODE BEFORE IT "CRASHES" WE MAY WISH TO 
INVOKE THE 957 MONITOR AT THE START OF OUR JOB'S EXECUTION. 

THIS CAN EASILY BE ACCOMPLISHED BY PLACING A "CAUSE$INTERRUPTf3)" 
INSTRUCTION AT THE BEGINNING OF OUR CODE (IN OUR START TASK). 

MODIFY A SOURCE FILE fPARTIALLY SUPPLIED FOR YOU) NAMED :LAB: START. P86 
WITH THE "ALTER" TEXT EDITOR 

- ALTER :LAB: START. P86 

* THIS SOURCE FILE IS THE START TASK THAT CONFORMS TO THE FOLLOWING 
FLOWCHART 


CALL RQ$END$INIT$TASK 
CAUSE$INTERRUPT(3) 

CREATE THE "COMMON$ENTRY" TASK */* PRI=155 , STACKSIZE = 512 


** DELETE SELF ** 



******* LAB ONE (BASIC 10 SYSTEM) ******* 


STEP4: 

COMPILE THE SOURCE FILES (START. P86 AND BIOLAB. P86) 

- PLM86 : LAB: START. P86 

- PLM86 :LAB:BI0LAB.P86 

* IF ANY ERRORS OCCURRED DURING COMPILATION , YOU MUST FIX AND 
RECOMPILE BEFORE CONTINUING 

* IF COMPILATION IS SUCCESFUL THE COMPILER WILL CREATE FOR EACH OF 
THE SOURCE FILES: 

- A LIST FILE NAMED " :LAB: (SOURCE) .LST" 

- AN OBJECT FILE NAMED ":LAB: (SOURCE) .OBJ" 

LINK THE OBJECTS WITH THE INTERFACE LIBRARIES NEEDED (LARGE) 

LINK86 :LAB:START.OBJ,& 

:LAB:BIOLAB.OBJ,& 

/RMX5.0/DUTILS/EPIFL.LIB,& 

/RMX5.0/DUTILS/IPIFL.LIB,& 

/RMX5.0/DUTILS/RPIFL.LIB & 

TO :LAB:JOB.LNK & 

NOMAP 

LOCATE THE LINKED MODULE TO AN^ ABSOLUTE ADDRESS 
L0C86 :LAB:JOB.LNK & 

TO : LAB: LAB JOB & 

SCO) SEGSIZE(STACK(0)) & 

ORDER ( CLASSES ( CODE , DATA , STACK ) ) & 

ADDRESSES ( CLASSES ( CODE ( 1040H ) ) ) & 

NOINITCODE & 

OC(PURGE) 

AND FINALLY ADD THE LOCATED MODULE TO THE OTHER PRECONFIGURED 
PARTS OF OUR SYSTEM 

LIB86 

DELETE : LAB : RMX86 ( STARTMOD ) 

ADD : LAB: LAB JOB to :LAB:RMX86 

EXIT 

* IN THE LINKING PROCESS OBSERVE THAT WE LINKED THE START MODULE FIRST 

* 1!! NO WARNINGS OR ERRORS DURING LINK 

* !!! SOME WARNINGS ARE OK DURING LOCATE (SEE INSTRUCTOR) 

* :LAB:RMX86 IS A "GIVEN" FILE THAT CONTAINS: 

- A PRECONFIGURED NUCLEUS 

- A PRECONFIGURED BIOS 

- A PRECONFIGURED SDB 

- A PRECONFIGURED ROOT JOB 

* THE STUDENT MAY "OPTIONALLY" USE A "GIVEN" SUBMIT FILE THAT WILL 
COMPILE , LINK , LOCATE AND ADD THE FINAL MODULE TO THE SYSTEM 


- SUBMIT :LAB:JOB.CSD 
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******* LAB ONE (BASIC 10 SYSTEM) 


**★★★** 


STEPS: 

* A LOCATE MAP AND SOURCE LISTING WILL HELP YOU DEBUG YOUR CODE IF 
PROBLEMS ARISE . THIS IS THE TIME TO GET THE LISTINGS OUT 

YOU ARE NOW READY TO "BOOT" YOUR NEWLY CREATED SYSTEM 

IF YOUR EXECUTION VEHICLE IS THE SAME AS THE DEVELOPMENT STATION 
THEN: 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 
-BOOT THE NEW SYSTEM 
.B /"TEAM NAME "/LABI /RMX86 

IF YOUR EXECUTION VEHICLE DIFFERS FROM THE DEVELOPMENT STATION 
THEN: 

-COPY THE NEWLY CREATED BOOTABLE SYSTEM INTO A FLOPPY. 

( COPY :LAB:RMX86 OVER :FD0:RMX86 ) 

-PRESS INTERRUPT- ON EXECUTION VEHICLE FRONT PANEL 

-BOOT THE NEW SYSTEM 

.B /RMX86 

* THE 957 DEBUG MONITOR IS PRESENT AND CAN BE USED TO DEBUG 

YOUR CODE IF NESSESARY. PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

* GOOD LUCK...! 
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CHAPTER 3 

RMX 86 EXTENDED I/O SYSTEM 

-An Application Programmer's View 

• WHY USE EIOS? AUTOMATIC 





WHY USE THE EXTENDED I/O SYSTEM? 


• REDUCE DEVELOPMENT COST 


• AUTOMATIC BUFFERING 


f SYNCHRONOUS SYSTEM CALLS 


• FREES PROGRAMMER FROM TEDIOUS DETAILS 




SYNCHRONOUS LEVEL I/O OPERATIONS (EIOS) 


• PROGRAMMER DOES NOT HAVE TO USE RESPONSE MAILBOXES 


• SYSTEM CALLS REQUIRE FEWER PARAMETERS 


• NEED TO CHECK ONLY ONE STATUS AFTER THE CALL 
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EIOS OPERATIONS 


AFTER A FILE CONNECTION HAS BEEN ESTABLISHED. 
THE RQ$S$OPEN SYSTEM CALL OPENS A CONNECTION 
FOR I/O OPERATIONS. 

• THE RQ$S$OPEN SPECIFIES 

- A FILE MAY BE 

READ ONLY 
WRITE ONLY 
READ OR WRITE 

- NUMBER OF BUFFERS DESIRED 

f COMMANDS ON OPEN FILES 
READ 
WRITE 
SEED 
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OPENING A FILE 


CALL RQ$S$OPEN (FILE$CONNECTION$TOKEN. MODE. NUM$BUF.aSTATUS); 


MODE: MODE OF ACCESS DESIRED 

VALUE MODE 

1 OPEN FOR READING 

2 OPEN FOR WRITING 

3 OPEN FOR READING AND WRITING 


• CONTROL IS RETURNED ONLY AFTER I/O HAS BEEN PERFORMED. 
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THE RQiS$READ$MOVE SYSTEM CALL 


• ALLOWS READING FROM AN OPEN FILE 


• COUNT BYTES ARE READ STARTING AT FILE POINTER 



THE RQ$S$WRITE$MOVE SYSTEM CALL 


• ENABLES ANY NUMBER OF BYTES TO BE WRITTEN 
FROM A USER BUFFER INTO AN OPEN FILE 

• THE DATA IS WRITTEN BEGINNING AT THE CURRENT 
SETTING OF THE FILE POINTER 


^TUAL - RQ$S$WRlTEtHOVE (FILEtCONWECTlQWSTOKEN. aBUFFFR. rmiMT 
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BUFFERING METHODS 


• ONE BUFFER ONLY 

- THE EIOS WILL WRITE OR READ INFORMATION ONE BUFFER AT 
A TIME (BLOCKING). 

• TWO OR MORE BUFFERS 

- ALLOWS BLOCKING AND OVERLAPPED I/O BY USING READ-AHEAD. 
WRITE-BEHIND ALGORITHMS. 

• ZERO BUFFERS 

- THE EIOS WILL ACCESS THE FILE gm TIME THE APPLICATION 
READS OR WRITES TO THE FILE. 
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THE RQ$S$SEEK SYSTEM CALL ■ 

• MOVES THE FILE POINTER FOR AN OPENED FILE 
TO ANY BYTE POSITION IN THE FILE 

• HI$PTR$MOVE. LOW$PTR$MOVE = 

WORD PAIR CONTAINING A 32-BIT UNSIGNED NUMBER 

CALL RQ$S$SEEK (FILE$CO NNECTION$TOKEN. MODE. HI$PTR$MOVE. LOW$PTR$MOVE. aSTATUS); 

MODE 
1 

2 
3 
A 
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THE RQ$S$CLOSE SYSTEM CALL 

• CLOSES AN OPEN FILE CONNECTION 

• A FILE CONNECTION IS CLOSED BY THE PROGRAMMER 

- IF I/O OPERATIONS ARE COMPLETE 

- IF THE OPEN MODE OR SHARED STATUS IS TO BE CHANGED 


CALL RQ$S$CLOSE (FILE$CONNECTION$TOKEN. EXCEPT$PTR); 
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El OS FILE ATTACH 


• IF THE FILE ALREADY EXISTS THEN THE USER MAKES AN "ATTACH$FILE" 
SYSTEM CALL. 


FILE$CONNECTION$TOKEN = RQ$S$ATTACH$FILE (PATH$PTR. aSTATUS). 


SEE EIOS REFERENCE MANUAL FOR DETAILS. 
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El OS SYSTEM CALLS FOR FILES 


SYSTEM 

PROGRAMMER 


APPLICATION 

PROGRAMMER 


- LOGICAL$ATTACH$DEVICE 


CREATE$FILE OR ATTACH$FILE 
OPEN 
READ 

SEEK FILE 

WRITE ACCESS 

CLOSE 

DELETE$CONNECTION OR 
DELETE$FILE 


- LOGICAL$DETACH$DEVICE 
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CHAPTER 4 


RMX 86 EXTENDED I/O SYSTEM 

-A System Programmer's View 

• LOGICAL NAMES 

t DEVICE CONNECTIONS 
0 10 JOBS 

• DEFAULT TOKENS 


L 















THE El OS DEVICE CONNECTION 


ROOT JOB DIRECTORY 

ASCII NAKE 

OBJECT TOKEN 

*INTE$6*TASK' 

8C58 

'MBXl' 

9‘!5C 

• 

• 

'Ffl' 

846C 


• 


• THE El OS PHYSICALLY 
ATTACHES TO THE DEVICE 

• THEN CATALOGS THE 
DEVICE CONNECTION TOKEN 
UNDER A LOGICAL NAME 



SYSTEM 

PROGRAMMER 


APPLICATION 

PROGRAMMER 



EIOS LOGICAL ATTACHMENT 
f LOGICAL ATTACH IS ACCOMPLISHED THROUGH 


CALL RQ$S$LOGICAL$ATTACH$DEVICE(LOG$NAME.DRV$NAME. FILE$DRIVER. aSTATUS), 


CALL RQ$A$LOGICAL$ATTACH$DEVICE 0(4' :F(J: a(2/F0'), 4. 3STATUS) 










THE 10 JOB 


• THE 10 JOB DIFFERS FROM A NORMAL JOB 

- THERE ARE THREE ENTRIES IN THE OBJECT DIRECTORY 
OF THE JOB UNDER THE NAMES "RQ6L0BAL". AND "R7USER" 



10 JOB CREATION 


TO CREATE AN 10 JOB 


JOB$TOKEN = RQ$CREATE$IO$JOB (POOL$MIN. POOL$MAX. 

EXCEPT$HANDLER. JOB$FLAGS, 
TASK$PRIORITY. START $ADDRESS. 
DATA$SEG. STACK$PTR. 
STACK$SIZE. TASKSFLAGS. 
MSG$MBOX. aSTATUS); 


REFER TO EXTENDED 10 SYSTEM REFERENCE MANUAL. 
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I/O JOB DELETION 


f TO DELETE AN I/O JOB 

CALL RQ$EXIT$IO$JOB (USER$FAULT$CODE. 

RETURN$DATA$PTR. 

aSTATUS); 


REFER TO EXTENDED 10 SYSTEM REFERENCE MANUAL. 



"CATCH 22" 


t AN I/O JOB CAN ONLY BE CREATED BY AN I/O JOB 

f THE SYSTEM PROGRAMMER DEFINES I/O JOBS DURING CONFIGURATION 
OF THE EXTENDED I/O SYSTEM (TO BE DISCUSSED LATER) 


• THESE I/O JOBS WILL BE CHILD JOBS OF THE EIOS 
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EIOS LOGICAL NAME SEARCH SEQUENCE 


• THE EIOS SEARCHES THREE OBJECT DIRECTORIES FOR THE 
LOGICAL NAME 

• FIRST. THE OBJECT DIRECTORY OF THE LOCAL JOB 

• SECOND. THE OBJECT DIRECTORY OF THE GLOBAL JOB 

- A JOB THAT HAS MORE "SCOPE" THAN THE LOCAL JOB 
BUT LESS "SCOPE" THAN THE ROOT JOB 

• THIRD. THE OBJECT 'DIRECTORY OF THE ROOT JOB 
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THE DEFAULT PREFIX 


• THE DEFAULT PREFIX IS A DEVICE OR FILE CONNECTION TOKEN 

• IT IS CATALOGED IN THE LOCAL JOB DIRECTORY UNDER THE 
ASCII NAME "$" 

• IF A TASK FAILS TO SPECIFY A CONNECTION DURING A SYSTEM CALL 
THAT REQUIRES IT. THE EIOS USES THE DEFAULT PREFIX 


i 


j 






EIOS EXERCISE 


1) WRITE THE CODE NECESSARY TO WRITE A STRING OF DATA TO A FILE 
ON A SBC204 SD/SS FLOPPY 

* GIVEN 

- THE FLOPPY HAS ALREADY BEEN FORMATTED 

- THE NAME OF THE DEVICE IS F0 

- THE NAME OF THE FILE IS 'COMPANY/EMPLOYEE/PERSONAL' 


- THE FILE ALREADY EXISTS 

- THE DATA TO BE WRITTEN AT THE END OF THE FILE 

- THE DATA IS 'L. JONES, 5050 MAIN DRAG, 3710217' 



4-12 


******* LAB TWO (EXTENDED 10 SYSTEM) 




BJECTIVES: 

EXECUTE A STUDENT EXTENDED 10 APPLICATION JOB IN AN RMX86 O.S. ENVIROMENT 

INTRODUCE (EIOS) SYSTEM CALLS: 

- RQ$S$CREATESFILE 

- RQSSSOPEN 

- RQ$S$READ$MOVE 

- RQ$S$SEEK 

- RQSS$WRITE$MOVE 

- RQ$S$CLOSE 

- RQ$EXIT$IO$JOB 

CREATE SOURCE CODE: 

- A SOURCE FILE NAMED START. P86 

- A SOURCE FILE NAMED EI0LAB.P86 

COMPILE fPLM86), LINK, AND LOCATE AN APPLICATION JOB, THAT WILL CALL UPON 
THE EIOS TO COMMUNICATE WITH A TERMINAL AND A FILE IN A FLOPPY 


TEPl: 

USE THE ATTACHSFILE COMMAND TO ATTACH THE DIRECTORY NAMED (/"TEAM NAME'VLABP) 
AS THE LOGICAL NAME (:LAB:) 

- AFILE /"TEAM NAMe»/lAB2 AS :LAB: 

* FOR THE REST OF THIS LAB WE WILL USE THIS LOGICAL NAME * 



f Use extended 10 system calls 
0 Read and write to/from a terminal and a floppy 
0 The student will be given the nucleus, BIOS, EIOS AND SDB 
0 The student will supply the LAB2J0B and LAB2RJB 




STEP2: 


******* LAB TWO (EXTENDED 10 SYSTEM) ★**★*★* 


MODIFY A SOURCE FILE rPARTIALLY SUPPLIED FOR YOU) NAMED :LAB:EI0LAB.P86 
WITH THE "ALTER" TEXT EDITOR 

- ALTER :LAB:EI0LAB.P86 

* THIS SOURCE FILE IS THE APPLICATION TASK THAT CONFORMS TO THE FOLLOWING 
FLOWCHART 

CREATE A BUFFER */* LENGTH=80 

CREATE FILE CONNECTION TO TERMINAL */* 0(4, ':T0:') , *N0TE1 
CREATE FILE CONNECTION TO FLOPPY */* OH 3, ' :FD0:LAB2DATAM , *N0TE1 
OPEN TERMINAL FILE */* (R/W) , SHARE ALL , *N0TE1 
OPEN FLOPPY FILE */* (R/W) , SHARE ALL , *NOTEI . 

WRITE READY MESSAGE TO TERMINAL */* 

ACTUAL = 80; 


DO WHILE ACTUAL GREATER THAN 2 


READ FROM TERMINAL */* 

WRITE TO FLOPPY 

•k jk 

READ FROM FLOPPY 

k jk 

SEEK TO EOF MINUS 

ACTUAL */* 

WRITE TO TERMINAL 

★ fk 


CLOSE TERMINAL FILE */* *N0TE1 


CLOSE FLOPPY FILE */* *N0TE1 


** DELETE SELF ** CALL EXIT$IO$JOB 


*N0TE1: VALIDATE BY CHECKING STATUS = E$OK 

THE SOURCE CODE SUPPLIED DOES NOT VALIDATE CONNECTIONS 

THE STUDENT MAY WISH TO IMPLEMENT THIS FUNCTIONALITY WHEN MODIFYING 

THE SOURCE CODE 
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******* LAB TWO (EXTENDED ID SYSTEM) 




STEPS: 


* ROOT JOBS ABSOLUTELY ADDRESS THE STARTING LOCATION OF THE STUDENT'S 
JOB CODE. THE ENTRY POINT MAY VARY IF INTERNAL PROCEDURES OR 
CHARACTER CONSTANTS ARE USED. 

FOR THIS REASON IT IS ADVISABLE TO CREATE AND LINK A START TASK TO 
THE REST OF THE APPLICATION CODE TO FIX THE ENTRY POINT'S OFFSET 
INTO THE CODE 

* THIS APPLICATION JOB WILL BE A SECOND LEVEL JOB. A TASK WITHIN THIS 
JOB IS NOT REQUIRED TO MAKE A CALL TO RQ$END$INIT$TASK, THE EIOS CODE 
SUPPLIES A TASK THAT CALLS RQ$END$INIT$TASK 

* IN ORDER TO DEBUG OUR CODE BEFORE IT "CRASHES" WE MAY WISH TO 
INVOKE THE 957 MONITOR AT THE START OF OUR JOB'S EXECUTION. 

THIS CAN EASILY BE ACCOMPLISHED BY PLACING A "CAUSE$INTERRUPTf3)" 
INSTRUCTION AT THE BEGINNING OF OUR CODE (IN OUR START TASK). 

MODIFY A SOURCE FILE (PARTIALLY SUPPLIED FOR YOU) NAMED : LAB: START. P85 
WITH THE "ALTER" TEXT EDITOR 

- ALTER :LAB:START.PS6 

* THIS SOURCE FILE IS THE START TASK THAT CONFORMS TO THE FOLLOWING 
FLOWCHART 


CAUSE$INTERRUPT(3) 

CREATE THE "COMMON$ENTRY" TASK */* PRI=155 , STACKSIZE = 513 
• ** DELETE SELF ** 
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******* LAB TWO f EXTENDED 10 SYSTEM) *★★***★ 

STEP4: 

COMPILE THE SOURCE FILES (START. P86 AND EI0LAB.P86) 

- PLM86 : LAB: START. P86 

- PLM86 :LAB:EI0LAB.P86 

* IF ANY ERRORS OCCURRED DURING COMPILATION , YOU MUST FIX AND 
RECOMPILE BEFORE CONTINUING 

* IF COMPILATION IS SUCCESFUL THE COMPILER WILL CREATE FOR EACH OF 
THE SOURCE FILES: 

- A list’ FILE NAMED " :LAB: fSOURCE) .LST" 

- AN OBJECT FILE NAMED " :LAB: fSOURCE) .OBJ" 

LINK THE OBJECTS WITH THE INTERFACE LIBRARIES NEEDED (LARGE) 

LINK86 : LAB : START. OB J,& 

:LAB:EIOLAB.OBJ,& 

/RMX5.0/DUTILS/EPIFL.LIB,& 

/RMX5.0/DUTILS/IPIFL.LIB,& 

/RMX5.0/DUTILS/RPIFL.LIB & 

TO :LAB:JOB.LNK & 

NOMAP 

LOCATE THE LINKED MODULE TO AN ABSOLUTE ADDRESS 
L0C86 :LAB:JOB.LNK & 

TO : LAB: LAB JOB & 

SC(3) SEGSIZEfSTACKfO)) & 

ORDER f CLASSES f CODE , DATA , STACK ) ) & 

ADDRESSES f CLASSES f CODE f 1040H ) ) ) & 

NOINITCODE & 

OCfPURGE) 

AND FINALLY ADD THE LOCATED MODULE TO THE OTHER PRECONFIGURED 
PARTS OF OUR SYSTEM 

LIB86 

DELETE :LAB:RMX86(STARTM0D) 

ADD : LAB: LAB JOB to :LAB:RMX86 

EXIT 

* IN THE LINKING PROCESS OBSERVE THAT WE LINKED THE START MODULE FIRST 

* !!! NO WARNINGS OR ERRORS DURING LINK 

* !!! SOME WARNINGS ARE OK DURING LOCATE (SEE INSTRUCTOR) 

* :LAB:RMX86 IS A "GIVEN" FILE THAT CONTAINS: 

- A PRECONFIGURED NUCLEUS 

- A PRECONFIGURED BIOS 

- A PRECONFIGURED EIOS 

- A PRECONFIGURED SDB 

- A PRECONFIGURED ROOT JOB 

* THE STUDENT MAY "OPTIONALLY" USE A "GIVEN" SUBMIT FILE THAT WILL 
COMPILE , LINK , LOCATE AND ADD THE FINAL MODULE TO THE SYSTEM 


- SUBMIT :LAB:JOB.CSD 
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**★*★★* 


LAB TWO (EXTENDED 10 SYSTEM) ******* 


STEPS: 

* A LOCATE MAP AND SOURCE LISTING WILL HELP YOU DEBUG YOUR CODE IF 
PROBLEMS ARISE . THIS IS THE TIME TO GET THE LISTINGS OUT 

YOU ARE NOW READY TO "BOOT" YOUR NEWLY CREATED SYSTEM 

IF YOUR EXECUTION VEHICLE IS THE SAME AS THE DEVELOPMENT STATION 
THEN: 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 
-BOOT THE NEW SYSTEM 
.B /"TEAM NAME"/LAB2/RMX86 

IF YOUR EXECUTION VEHICLE DIFFERS FROM THE DEVELOPMENT STATION 
THEN: 

-COPY THE NEWLY CREATED BOOTABLE SYSTEM INTO A FLOPPY. 

( COPY :LAB:RMX86 OVER :FD0:RMX86 ) 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

-BOOT THE NEW SYSTEM 

.B /RMX86 

* THE 957 DEBUG MONITOR IS PRESENT AND CAN BE USED TO DEBUG 

YOUR CODE IF NESSESARY. PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

* GOOD LUCK...! 


4-17 




CHAPTER 5 

WRITING DEVICE DRIVERS 

-Generalities 

f INDEPENDENT 10 

• DRIVER COMPONENTS, 
t THE DUIB 

• THE I/O REQUEST 
t DRIVER FUNCTIONS 




DEVICE INDEPENDENT I/O 

• APPLICATION TASKS COMMUNICATE WITH FILE DRIVERS 

- THIS ALLOWS TASKS TO MANIPULATE ALL FILES IN THE SAME MANNER 

• FILE DRIVERS COMMUNICATE WITH DEVICE DRIVERS 

- THEY PROVIDE THE INTERFACE BETWEEN SOFTWARE AND HARDWARE 

• THIS STANDARD INTERFACE HAS ADVANTAGES 

- THE HARDWARE CAN BE CHANGED WITHOUT EXTENSIVE MODIFICATION 
TO THE SOFTWARE 

- THE I/O SYSTEM CAN SUPPORT A GREATER RANGE OF DEVICES. 


V 
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FILE DRIVER 



5 ' 
















THE DUIB 

• THE DEVICE UNIT INFORMATION BLOCK IS A TABLE OF VALUES DESCRIBING 
THE COMPONENTS OF A DEVICE DRIVER. 

t IT IS CREATED BY THE SYSTEM PROGRAMMER DURING CONFIGURATION OF 
THE BASIC I/O. 

• THE DUIB BINDS THE FILE DRIVER TO THE DEVICE DRIVER BY DESCRIBING 
POINTERS TO THE DEVICE DRIVER PROCEDURES. 


<PROC 


FILE 

DRIVER 





















THE I/O REQUEST 

• WHEN THE APPLICATION TASK CALLS THE BASIC I/O SYSTEM 
AN lORS IS GENERATED (I/O REQUEST SEGMENT) 


APPLICATION TASK j BASIC I/O 


CALL RQ$A$READ 



APPLICATION'S 
V MEMORY 

' POOL r 
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THE REGION 

• PROTECTION OF THE QUEUE IS ACCOMPLISHED THROUGH A REGION 

- THE TASK CALLS THE iRMX O.S. 

TO GAIN ACCESS TO THE QUEUE 


THE TASK MANIPULATES OBJECTS 
IN THE QUEUE 


THE TASK THEN CALLS THE iRMX 
O.S. TO RELEASE ACCESS TO ' 
THE QUEUE 
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SOME FACTS ABOUT REGIONS 


• ONCE A TASK GAINS ACCESS TO A REGION 

- THE PRIORITY OF THE TASK MAY BE TEMPORARILY RAISED 

- THIS OCCURS AUTOMATICALLY IF THE REGION IS PRIORITY BASED. 
AND THERE IS A TASK OF HIGHER PRIORITY WAITING TO USE 

THE REGION 

- THE TASK CANNOT BE SUSPENDED OR DELETED UNTIL IT SURRENDERS 
ACCESS TO THE REGION 
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THE (DIT) AND (UIT) 


t ALL DUIB'S ARE FIXED LENGTH 

• SOME DEVICE DRIVERS NEED MORE INFORMATION 

• THE SYSTEM PROGRAMMER MAY "OPTIONALLY" PROVIDE TWO EXTRA 
TABLES OF UNBOUND LENGTH 

DEVICE UNIT INFO BLOCK ‘ DEVICE INFO TABLE UNIT INFO TABLE 



• THE DUIB CONTAINS POINTERS TO THESE TABLES 


EXERCISE 

• WHY ARE THE ADDRESS FIELDS IN THE DUIB. FOR THE DRIVER 
PROCEDURES. ONLY WORD FIELDS AND NOT POINTER FIELDS? 


• NAME SOME GENERAL DEVICE DRIVER COMPONENTS. 


f NAME ONE ADVANTAGE OF A REGION vs. SEMAPHORE FOR RESOURCE 
PROTECTION. 
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DEVICE DRIVER TYPES 


• THERE ARE THREE TYPES OF DEVICE DRIVERS IN THE iRMX ENVIRONMENT 

- COMMON DEVICE DRIVER 

- RANDOM ACCESS DEVICE DRIVER 

- CUSTOM DEVICE DRIVER 
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CHAPTER 6 

THE CUSTOM DEVICE DRIVER 






THE CUSTOM DEVICE DRIVER 

• THE CUSTOM DEVICE DRIVER IS NEEDED IF 

- TWO OR MORE INTERRUPT LEVELS PER DEVICE ARE REQUIRED 

- PRIORITY ORDERED REQUEST QUEUE IS REQUIRED 

- THE DEVICE DOES NOT FIT INTO THE COMMON RANDOM ACCESS 
DEVICE CATEGORY (TO BE DISCUSSED LATER) 


WIT I WIT 1 
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CUSTOM DEVICE DRIVER COMPONENTS 


• TO WRITE A CUSTOM DEVICE DRIVER YOU MUST PROVIDE 


- AN INITIALIZE I/O PROCEDURE 


FINISH 

10 

PROC 


A FINISH I/O PROCEDURE 


- A QUEUE I/O PROCEDURE 


- A CANCEL I/O PROCEDURE 


CANCEL 

10 

PROC 


- A DEVICE INTERRUPT TASK AND HANDLER 


RQSIGNAL 




THE DEVICE INTERRUPT HANDLER 


• EXAMPLE INTERRUPT HANDLER 

- WHEN THE DEVICE CONTROLLER FINISHES A REQUEST (READ. SEEK, 
IT GENERATES AN INTERRUPT. 

- THE INTERRUPT HANDLER THEN SIGNALS THE INTERRUPT TASK 

HARDWARE 

UNIT 0 UNIT 1 


7 ^/ 


RQ$SIGNAL 



r.;, 









EXAMPLE DEVICE INTERRUPT TASK 


IDENTIFY HANDLER S TASK TO THE RMX 86 O.S. 


DO FOREVER 


WAIT FOR HANDLER TO SIGNAL 


GAIN ACCESS TO REGION 


REMOVE lORS FROM QUEUE 


SEND lORS TO A RESPONSE MAILBOX (IMBEDDED IN lORS) 


SEND COMMANDS TO DEVICE TO START NEXT REQUEST (IF ANY!) 


SURRENDER ACCESS TO REGION 




HANDLER 




RQSSIGNAL 




HOW DOES THE FIRST REQUEST GET STARTED? 
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THE QUEUE I/O PROCEDURE 


• THE BASIC I/O SYSTEM CALLS THE QUEUE I/O PROCEDURE 
IN THE FOLLOWING MANNER 


CALL QUEUE$IO(IORS$T.DUIB$P.D$DATA$T); 


WHERE: 

- IORS$T IS THE TOKEN FOR THE I/O 


SEGMENT 


- DUIB$P IS A POINTER TO THE DEVICE UNIT INFORMATION BLOCK 
OF THE DEVICE 

- D$DATA$T IS A TOKEN FOR A DATA STORAGE AREA (CREATED BY THE 
INIT I/O PROCEDURE). CONTAINS (HEAD OF QUEUE. REGION TOKEN. 
. . .INTERRUPT TASK TOKEN. . . .ETC) 
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THE INIT I/O PROCEDURE 


• THE BASIC I/O SYSTEM CALLS THE INIT I/O PROCEDURE IN THE 
FOLLOWING MANNER: 


CALL INIT$IO(DUIB$P.D$DATA$P.STATUS$P); 


WHERE: 


- DUIB$P IS A POINTS TO THE DEVICE UNIT INFORMATION BLOCK OF THE DEVICE 

- D$DATA$P IS A POINTER TO A WORD WHERE THE INIT I/O PROCEDURE 
PLACES THE TOKEN FOR A DATA STORAGE AREA 


- STATUS$P IS A POINTER TO A WORD WHERE THE INIT $1/0 PROCEDURE 
PLACES A STATUS OF THE INITIALIZE OPERATION (SUCCESSFUL OR NOT 
SUCCESSFUL) 
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THE FINISH I/O PROCEDURE 


I THE BASIC I/O CALLS THE FINISH I/O PROCEDURE IN 
THE FOLLOWING MANNER: 

CALL FINISH$IO(DUIB$P.D$DATA$T)j 


- DUIB$P IS A POINTER TO THE DEVICE UNIT INFORMATION 
BLOCK OF THE DEVICE 


- D$DATA$T IS A TOKEN FOR THE DATA STORAGE AREA 
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THE CANCEL I/O PROCEDURE 


§ THE BASIC I/O SYSTEM CALLS THE CANCEL I/O PROCEDURE IN 
THE FOLLOWING MANNER: 

CALL CANCEL$IO(CANCEL$ID.DUIB$P.D$DATA$T)j 


WHERE: 

- CANCEL$ID IS A WORD CONTAINING THE ID # OF THE REQUESTS. 
WAITING IN THE QUEUE. TO BE CANCELLED. 

- DUIB$P IS A POINTER TO THE DEVICE UNIT INFORMATION BLOCK 
OF THE DEVICE 

- D$DATA$T IS A TOKEN FOR THE DATA STORAGE AREA 
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6-15 



EXERCISE 

0 WRITE THE QUEUE$I/0 PROCEDURE HEADING AND DECLARATIONS 
IN PL/M 86. 

0 WHAT IS A DATA STORAGE AREA? 

0 WHEN IS THE INIT$I/0 PROCEDURE CALLED? 

0 WHEN IS CANCELS I/O CALLED? 

0 HOW DOES THE INTERRUPT HANDLER KNOW WHERE THE DATA STORAGE 
AREA IS LOCATED? 
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CHAPTER 7 
DEVICE DRIVERS 

(Random Access and Common Device Drivers) 

f COMPONENTS 

• THE INTERRUPT PROCEDURE 
t THE START PROCEDURE 
f DEVICE INFORMATION TABLE 



THE COMMON DEVICE DRIVER 


• SIMPLE DEVICES 

E.G. LINE PRINTERS. USART 

• FIFO MECHANISM FOR QUEUING REQUESTS IS SUFFICIENT 

• ONLY ONE INTERRUPT LEVEL IS NEEDED TO SERVICE A DEVICE 

• DATA READ OR WRITTEN BY THESE DEVICES DOES NO,I NEED TO BE 
BROKEN UP INTO BLOCKS. 




THE RANDOM ACCESS DEVICE DRIVER 


• COMP-LEX DEVICES 

E.G. HARD DISK. BUBBLE MEMORY. FLOPPY 

• FIFO MECHANISM FOR QUEUING REQUESTS IS SUFFICIENT 

• ONLY ONE INTERRUPT LEVEL IS NEEDED TO SERVICE A DEVICE 

f I/O REQUESTS MUST BE BROKEN UP INTO BLOCKS OF SPECIFIC LENGTH 

• THE DEVICE SUPPORTS RANDOM ACCESS SEEK OPERATIONS 


O 



I/O SYSTEM SUPPLIED PROCS 




THE BASIC 10 SYSTEM PROVIDES PROCEDURES THAT COMPRISE THE 
BULK OF WRITING A RANDOM ACCESS OR COMMON DEVICE DRIVER. 

- PROCEDURE NAMES - 

• "RAD$INIT$IO" OR "INITSIO" 

t "RAD$FINISH$IO OR "FINISHSIO 

• "RAD$QUEUE$IO" OR "QUEUE$IO" 
f "RAD$CANCEL$IO" OR "CANCEL$IO 



// 


// 


i 


i 

















THE DEVICE$INTERRUPT PROCEDURE 


• THE INTERRUPT TASK. SUPPLIED BY THE 10 SYSTEM. CALLS THE INTERRUPT 
PROCEDURE IN THE FOLLOWING MANNER: 

CALL DEVICE$INTERRUPT(IORS$P. DUIB$P. DDATA$P); 

WHERE: 

-IORS$P IS A POINTER TO THE I/O REQUEST SEGMENT 

-DUIB$P IS A POINTER' TO THE DEVICE UNIT INFORMATION BLOCK 

-DDATASP IS A POINTER TO A USER REQUESTED RAM SEGMENT (SCRATCH PAD AREA) 
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DEVICE DEPENDENT PROCS 

• TO WRITE A RANDOM ACCESS OR COMMON DEVICE DRIVER 
YOU MUST PROVIDE: 

SYSTEM SUPPLIED DEVICE DEPENDENT 
PROCS PROCS 


INIT 10 
PROC 


FINISH 10 
PROC 




DEVICE INIT 


DEVICE FINISH 


P 



• A DEVICE$INIT PROCEDURE 

• A DEVICESFINISH PROCEDURE 

• A DEVICE$START PROCEDURE 

• A DEVICE$STOP PROCEDURE 

• A DEVICESINTERRUPT PROCEDURE 
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EXAMPLE DEVICE! INTERRUPT PROCEDURE 


‘HANDLE THE INTERRUPT* 
REQUEST F^NISHB^ 


[ORS.DONE FIELD=TRUE 


ERROR HAS OCCURRED 


lORS. STATUS FIELD= 
ERROR 


lORS.DONE FIELD = 
TRUE 


RETURN 



THE DEVICE 1ST ART PROCEDURE 

• THE INTERRUPT TASK AND THE QUEUESIO PROCEDURE ^ SUPPLIED BY THE 
10 SYSTEM. CALLS THE DEVICE$START PROCEDURE IN THE FOLLOWING MANNER: 

CALL DEVICE$START(IORS$P. DUIB$P. DDATA$P)j 

WHERE: 

- IORS$P IS A POINTER TO THE I/O REQUEST SEGMENT 

- DUIB$P IS A POINTER TO THE DEVICE UNIT INFORMATION BLOCK 


-DDATA$P IS A POINTER TO A USER REQUESTED RAM SEGMENT 
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EXAMPLE DEVICE$START PROCEDURE 


V^VALID lORS. FUNCTION 

? 


READ 

WRITE 

SEEK 

START 

READ 

START 



WRITE 

START 

SEEK 


DO CASE I ORS. FUNCTION 


SPECIAL 

ATTACH 

— ^ 




START 

ATTACH 

DETACH 

OPEN 

START 

(B.S.T^ 

START 

DETACH 

START 

OPEN 

I ORS 
DONE 

-true ■ 

lORS 

DONE 

T^UE 

“lOR^ 

Dj)NE 

■ t"rue 


IF ERROR HAS OCCURRED 

9 


RETURN 



lORS. STATUS = ERROR 
lORS.DONT = TRUE 


THE DEVICE$INIT PROCEDURE 

• THE INIT$IO PROCEDURE. SUPPLIED BY THE 10 SYSTEM. 

CALLS THE DEVICE$INIT PROCEDURE IN THE FOLLOWING MANNER: 

CALL DEVICE$INIT(DUIB$P.DDATA$P.STATUS$P); 

WHERE: 

-DUIB$P IS A POINTER' TO THE DEVICE UNIT INFORMATION BLOCK 

-DDATA$P IS A POINTER TO A USER REQUESTED RAM SEGMENT 

-STATUS$P IS A POINTER TO A WORD WHERE THE RESULT OF THE CALL 
WILL BE STORED BY THE USER 
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THE DEVICE$FINISH PROCEDURE 

THE FINISH $10 PROCEDURE, SUPPLIED BY THE 10 SYSTEM, CALLS 
THE DEVICE$FINISH PROCEDURE IN THE FOLLOWING MANNER: 

CALL DEVICE$FINISH(DUIB$P, DDATASP); 

WHERE: 

-DUIB$P IS A POINTER TO THE DEVICE UNIT INFORMATION BLOCK 
-DDATA$P IS A POINTER TO A USER REQUESTED RAM SEGMENT 
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THE DEVICE$STOP PROCEDURE 




• THE CANCEL$IO PROCEDURE. SUPPLIED BY THE 10 SYSTEM. CALLS 
THE DEVICE$STOP PROCEDURE IN THE FOLLOWING MANNER: 

CALL DEVICE$STOP(IORS$P. DUIB$P. DDATA$P); 

WHERE; 

- IORS$P IS A POINTER TO THE I/O REQUEST SEGMENT 

- DUIB$P IS A POINTER TO THE DEVICE UNIT INFORMATION BLOCK 

- DDATA$P IS A POINTER TO A USER REQUESTED RAM SEGMENT 
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THE DIT STRUCTURE 
(DEVICE INFORMATION TABLE) 


LEVEL 

PRIORITY 1 

STACK$SIZE 

DATA$SIZE 

NUM$UNITS 

DEVICE$INIT 
DEVICE$FINISH 
DEVICE$$TART 
DEVICE$STOP 
DEVICES INTERRUPT 


USER MAY 

APPEND MORE FIELDS 


• REFER TO "GUIDE TO WRITING DEVICE DRIVERS" REFERENCE MANUAL. 
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t UNIT INFORMATION TABLES ARE CREATED BY THE SYSTEM PROGRAMMER 
DURING CONFIGURATION OF THE BASIC 10 SYSTEM. 


TRACK$SIZE 

MAX$RETRY 

RESERVED 


'USER MAY APPEND 
MORE FIELDS 



TABLES AND CALLS 


ylNIT^IO- 

^UEUE$IO- 


►DEVI CE$I NIT- 

/ 

'DEVI CE$ST ART 


'lOSSYSTEM 

/ 

/ 


^^NTERRUPT$HANDLER NTERRUPT$TASK^DEVI CE$INTERRUE] 


^CANCEL$IO 


/ / 

/// 


/ ^ ^^FINISHilO- V / -I 

' / / DEVICE INIT / / ' / 

/ ✓ DEVICE START / / / 


‘►DEVICEiSTOP'- 

/ 

►DEVICE$FINISH 


IHIT 10 

/ // 

DEVICE INIT 

QUEUE 10 

/ y 

DEVICE START 

CANCEL 10 


DEVICE INTERRUPT 

FINISH 10 


DEVICE STOP 



DEVICE FINISH 

UIT 



UIT 

— 1 



1- - 
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******* LAB THREE ^COMMON DEVICE DRIVER) ******* 


DBJECTIVES: 

EXECUTE A GIVEN APPLICATION JOB, THAT WILL CALL UPON THE BIOS 
TO COMMUNICATE WITH A LIGHT BOX 

THE STUDENT WILL WRITE A COMMON DEVICE DRIVER TO SUPPORT THE 
LIGHT BOX HARDWARE 

CREATE SOURCE CODE: 

- A SOURCE FILE NAMED DEVDRV.P86 

- A SOURCE FILE NAMED LBOXDUIB.SRC 

- A SOURCE FILE NAMED LBOXDUIT.SRC 


5TEP1: 

USE THE ATTACHSFILE COMMAND TO ATTACH THE DIRECTORY NAMED (/"TEAM NAME"/LAB3) 
AS THE LOGICAL NAME f:LAB:) 

- AFILE /"TEAM NAME"/LAB3 AS :LAB: 

* FOR THE REST OF THIS LAB WE WILL USE THIS LOGICAL NAME * 



t 

# 


Write a common device driver for the light box 
The student will be given the nucleus, SDB, application and root 
The student will supply init, start and interrupt procedures for 
the driver 

The student will build a BIOS with preconfigured ITABLE.A86 and 
IDEVCF.A86 
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******* LAB THREE fCOMMON DEVICE DRIVER) 




STEP2: 

MODIFY A SOURCE FILE (PARTIALLY SUPPLIED FOR YOU) NAMED :LAB:LBOXDUIB.SRC 
WITH THE "ALTER" TEXT EDITOR 

- ALTER :LAB:LBOXDUIB.SRC 

* THIS SOURCE FILE CONTAIN PARTIALLY WRITTEN SOURCE CODE TO THE DUIB TABLES 
NEEDED TO SUPPORT THE LIGHT BOX DRIVER 


STEP3; 

MODIFY A SOURCE FILE (PARTIALLY SUPPLIED FOR YOU) NAMED :LAB:LBOXDUIT.SRC 
WITH THE "ALTER" TEXT EDITOR 

- ALTER :LAB:LBOXDUIT.SRC 

* THIS SOURCE FILE CONTAIN PARTIALLY WRITTEN SOURCE CODE TO THE DIT TABLES 
NEEDED TO SUPPORT THE LIGHT BOX DRIVER 


STEP4: 

MODIFY A SOURCE FILE (PARTIALLY SUPPLIED FOR YOU) NAMED :LAB:DEVDRV.P86 
WITH THE "ALTER" TEXT EDITOR 

- ALTER :LAB:DEVDRV.P86 

* THIS SOURCE FILE CONTAIN PARTIALLY WRITTEN SOURCE CODE TO THE FOLLOWING 
PROCEDURES: 

- A LIGHT BOX DEVICE INTERRUPT PROCEDURE 

- A LIGHT BOX DEVICE START PROCEDURE 

- A LIGHT BOX DEVICE INIT PROCEDURE 
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******* LAB THREE (COMMON DEVICE DRIVER) ******* 


5TEP5: 

COMPILE THE SOURCE FILE DEVDRV.P86 
- PLM86 :LAB:DEVDRV.P86 

* IF ANY ERRORS OCCURRED DURING COMPILATION , YOU MUST FIX AND 
RECOMPILE BEFORE CONTINUING 

* IF COMPILATION IS SUCCESFUL THE COMPILER WILL CREATE FOR THE 

SOURCE FILE: 

- A LIST FILE NAMED LAB: (SOURCE) .LST" 

- AN OBJECT FILE NAMED ": LAB : (SOURCE) .OBJ" 


;TEP6: 

* WE MUST NOW ADD THE OBJECT CODE THAT. WE HAVE GENERATED TO 
THE BIOS SYSTEM 

* THEN WE MUST BUILD A LOADABLE SYSTEM THAT INCLUDES: 

- THE NUCLEUS 

- THE BIOS ( YOU SUPPLY THE LIGHT BOX DRIVER ) 

- THE SDB 

- THE APPLICATION JOB (SUPPLIED) THAT CALLS YOUR DRIVER 

- THE ROOT JOB 

* THIS IS ACCOMPLISHED THROUGH SEVERAL LINKS, LOCATES AND FINALLY 
USING THE LIB86 UTILITY 

* A SUBMIT FILE IS SUPPLIED 

- SUBMIT :LAB:ICU.CSD 


;TEP7: 

* A LOCATE MAP AND SOURCE LISTING WILL HELP YOU DEBUG YOUR CODE IF 
PROBLEMS ARISE . THIS IS THE TIME TO GET THE LISTINGS OUT 
REMEMBER THE MAP FILE IS :LAB:I0S.MP2 

YOU ARE NOW READY TO "BOOT" YOUR NEWLY CREAtED SYSTEM 

IF YOUR EXECUTION VEHICLE IS THE SAME AS THE DEVELOPMENT STATION 
THEN: 


-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 
-BOOT THE NEW SYSTEM 
.B /"TEAM NAME"/LAB2/RMX86 

IF YOUR EXECUTION VEHICLE DIFFERS FROM THE DEVELOPMENT STATION 
THEN: 


-COPY THE NEWLY CREATED BOOTABLE SYSTEM INTO A FLOPPY. 

( COPY :LAB:RMX86 OVER :FD0:RMX86 ) 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 
-BOOT THE NEW SYSTEM 
.B /RMX86 

* THE 957 DEBUG MONITOR IS PRESENT AND CAN BE USED TO DEBUG 
YOUR CODE IF NESSESARY. PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 
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STEPS IN BUILDING THE BASIC I/O SYSTEM 


1) TWO CONFIGURATION FILES ARE NEEDED (ITABLE.A86 AND IDEVCF.A86) 

2) ASSEMBLE EACH CONFIGURATION FILE 

3) LINK AND LOCATE THE BIOS 



LOCATE MAP 


I0S.MP2 


ALTER I . . ..A86 


• ITABLE CONTAINS SYSTEM CALLS 
AND FILE DRIVERS AND TABLES 

• IDEVCF CONTAINS DEVICE DRIVERS 
INTO TABLES (DUIBS. DITS. UITS) 

• REFER TO CONFIGURATION .MANUAL 
THROUGH THE REST OF THIS CHAPTER 




ITABLE. A86 


XRQ_CREATE_USER \ 

ZRQ_INSPECT_USER \ 

ZRQ_DELETE_USER \ 

XRQ_SET_DEFAULT_USER X 
ZRQ_SET_DEFAULT_USER >-PARAMBTER INTERFACE 
XRQ_SET_DEFAULT_PREFIX / 

ZRQ_GET_DEFAULT_PREFIX / 

XRQ_A_PHYS 1 CAL_ATTACH_DEVI CEV. 

XRQ_A_PHYS I CAL_DETACH_DEVI GURATION I NTERFACE 


XRQ_POWER_DOWN 

XRQ_POWER_UP Pf 

XRQ.SETJIME"-........^ 

XRQ_GETJIME.-----^=»~'^*ME 1 

XNUM.F I LE_DRI VERS ( 4 
XAH ACH_DEV 1 CE_TASK_PR 10(129) 
XT IHER_TASK_PR 10 
;DUMMY_TIMER 

; NO_CREATE_FALSE^'\^^ 
;NO_TRUNCATE 
; NO_ALLOCATE 


■POWER-FAIL INTERFACE 


■TIME INTERFACE 


DEFINE FILE-DRIVER GLOBAL PARAM 


-OTHER FEATURES 


PHYSlCAL>-> 

NAMED 

STREAM, 


-REQUEST S lOS FILE-DRIVER CONFIGURATION TABLES 
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• 

IDEVCF.A86 







EXTRN 

INITIO: NEAR^v. 



EXTRN 

FINISHIO: NEAR^\^^ 



EXTRN 

QUEUEIO: NEAR 

EXTERNAL PROCEDURES 


EXTRN 

12041 NIT: NEAR 

DEFINITIONS 


EXTRN 

1204START: NEAR 



EXTRN 

12041 NTERRUPT: NEAR.^ 



% 




• 






J 
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IDEVCF.A86 (CONTINUED) 
; SPC 204 CONTROLLER UNIT 

DEFINE DUIB \ 


& 'F0', j NAME ( 

& 00BH. ; FILEDR 

& 0FFH. ; FUNCTS 

& 00H. j FLAGS 

& 128. ; DEV GR 

& 0E900H.03H. ; DEV SI 

& 0. ; DEVICE 

& 0. ; UNIT # 

& 0. ; DEVICE 

& INITIO. ; DRIVER 

& FINISHIO . j 
& QUEUE 10. 

& CANCELIO. ; 

& DINFO_204. ; DIT 
& VINFOJHUGART. ; UIT 


a 100. 

& 6 . 

& 129 

& > 


NAME (14) > 

FILEDRIVERS 

FUNCTS 

FLAGS 

DEV GRANUURITY 
DEV SIZE = 256256 
DEVICE # 

UNIT # 

DEVICE-UNIT # 
DRIVER PROCS 


DUIB 

DEFINITIONS 


; UPDATE TIMEOUT 
; NUMBER OF BUFFERS 
; INITIAL TASK PRIORITY 
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IDEVCF.A86 (CONTINUED) 


RADEV_DEV_INFO< ' 
; LEVEL 
t PRIORITY 
; STACK SIZE 
; DATA SIZE 
; NUM UNITS 
; DRIVER PROCS 


DEVICE INFO TABLE 


DW 0A0H ; BASE ADDRESS' 


E)aRA INFO MAY BE 
APPENDED HERE 
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THE SUBMIT FILE (86/330 STYLE) 

lOS.CSD 

.•ASSEMBLE THE TABLES 

ASM86 /RMX/DBI0S/ITABLEA86 WORKFI LES(: WORK: . .-WORK: ) 
ASM86 /RMX/DBI0S/IDEVCF.A86 WORKFILES(:WORK:.:WORK: ) 
jLink the bios 

LINK 86 /RMX/DBIOS/IOS.LIB(ISTART).& 
/RMX/DBIOS/ITABLE.OBJ .& 

/RMX/DBIOS/IDEVCF.OBJ 

/RMX/DBIOS/ITDR.LIB .& * FOUND IN Ml 

•/RMX/DHI/HI.LIB(HCONTC) 

/RMX/DBIOS/IOOPTl.LIB 
/RMX/DBIOS/IOS.LIB a 

/RMX/DNUCLUS/RPIFC. LIB .& ♦ COMPACT! 

TO /RMX/DBIOS/IOS.LNK & 

NO PUBLICS EXCEPT(RQAIOSINITTASK.RQAIOSINITERROR) 
.•LOCATE THE BIOS 

LOCATE 7RMXDBI0S/I0S.LNK & 

TO /RMX/DBIOS/IOS.LNK & 

SE6SIZE (STACK (0)) & 

ORDER(CUSSES(CODE.DATA)) & 

ADDRESSES (CLASSES (CODE (%!))) g_, ADDRESS OF BIO 


FOUND IN MISCELLANEOUS DISKETTE 


NOINITCODE 


^ADDRESS OF BIOS IS PASSED 
AS A PARAMETER 



LOCATE ADDRESSES 

• THE LOCATE PROGRAM GENERATES A MAP FILE CALLED 

/RMX/DBI0S/I0S.M12 

II EXAMINING THE MAP WE OBTAIN THE ENDING ADDRESS OF THE BIOS 
MEMORY MAP OF MODULE ISTART 
SEGMENT MAP 


START 

START 

LENGTH 

ALIGN 

NAME 

CUSS 

002m 

00216H 

0017H 

A 

(ABSOLUTE) 


07190H 

14E85H 

DCF6H 

W 

CODE 

CODE 

1AE86H 

14E93E 

000EF 

W 

PARAM_SEG 

CODE 

14E94H 

14E97H 

0004H 

W 

CONFIG.SEG 

CODE 

14E98H 

14B9BH 

0004H 

W 

POWER.SEG 

CODE 

14E9CH 

14E9FH 

0004H 

W 

TIMEJEG 

CODE 

14EA0H 

14EBBH 

001CH 

W 

FILE_DRIVER_IN 

-FO_SEG 

CODE 

14EBCH 

14F7BH 

00C0H 

W 

REQ_TABLE 

CODE 

14F7CH 

1504BH 

00D0H 

W 

IOS_TABLE 

CODE 

1504CH 

1509DH 

0052H 

W 

DATA 

DATA 

150A0H 

150AFH 

0010H 

G 

??SEG 


150B0H 

150B0H 

0000H 

W 

STACK 

STACK 

J50B^ 

150B0H 

0000H 

W 

MEMORY 

MEMORY 
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REMEMBER! 


• ADD A %JOB MACRO TO YOUR ROOT JOB 
j lOS JOB 

> • 
%JOB(0. %' OBJECT DIRECTORY SIZE ^ 

0600H. 0FFFFJ. %' POOL SIZE (MIN. MAX) 

0FFFFH. 0FFFFH. %' MAX OBJECTS AND TASKS 

0. %' MAX JOB PRIORITY 

0:0. 0 %' EXCEPTION HANDLER ADDR. MODE 

0. %' JOB FLAGS 

130. %• INIT TASK PRIORITY 

719:0 %' INIT TASK ENTRY ADDRESS 

0. %' INIT TASK DATA SEGMENT ADDRESS 

0:0. 200H %' INIT TASK STACK ADDRESS. STACK SIZE 

0) %' INIT TASK FLAGS 



THAT'S ALL FOLKS! 
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******* LAB FOUR (BIOS CONFIG THROUGH ICU) ******* 

IBJECTIVES: 

EXECUTE A GIVEN APPLICATION JOB, THAT WILL CALL UPON THE BIOS 
TO COMMUNICATE WITH A LIGHT BOX 

THE STUDENT WILL BUILD UPON LAB THREE TO CONFIGURE THE ALL THE 
PARTS NESSESARY TO EXECUTE THAT LAB 

THE STUDENT WILL USE THE INTERACTIVE CONFIGURATION UTILITY (ICU) 

;TEP1: 

USE THE ATTACH$FILE COMMAND TO ATTACH THE DIRECTORY NAMED (/"TEAM NAME"/LAB3) 
AS THE LOGICAL NAME (:LAB:) 

- AFILE /"TEAM NAME"/LAB3 AS :LAB: 

* FOR THE REST OF THIS LAB WE WILL USE THIS LOGICAL NAME * 
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******* LAB FOUR (BIOS CONFIG THROUGH ICU) 


STEP2: 


THE fICU) IS INVOKED BY TYPING THE FOLLOWING 
-ICU86 :LAB:ICU.DEF 

* WHERE ICU.DEF IS THE NAME OF THE FILE WE HAVE CHOSEN TO CONTAIN 
THE INFORMATION NEEDED TO CONFIGURE OUR O.S. 

WHEN THE ICU SIGN ON ENTER THE COMMAND C , TO MODIFY THE SCREENS 


STEPS: 


* TRY FILLING THE SCREENS WITHOUT LOOKING AT THESE FIRST, 
THEN MATCH YOUR ENTRIES TO THE ONES GIVEN HERE 

* IF YOU DO NOT UNDERSTAND AN ENTRY TYPE ? 

- E.G. OSP? <cr> 

* THE SCREEN FOR OUR LAB THREE CONFIGURATION FOLLOW 


Hardware 

fOSP) 80130 Operating System Extension (Yes/No) No 


(OTU) 80130 Timer Used f Yes/No) No 

fOPU) 80130 PIC Used fYes/No) No 

roCD) 80130 Copyright = 1981 ^Yes/No) Yes 

(BL) 80130 Base Address Location f40h-0FFFFh) OOOOH 

(BP) 80130 Base Port Address fO-OFFFFH) OOOOH 

fMP) 8259A Master Port (O-OFFFFH) OOCOH 

(MPS) Master PIC Port Separation (O-OFFH) 0002H 

(SIL) Slave Interrupt Levels fl-7/None) None 

(LSS) Level Sensitive Slaves H -7/None) None 

(LSP) Local Slave PICS (1-7/None) None 

• (TP) 8253 Timer Port (O-OFFFFH) OODOH 

(CIL) Clock Interrupt Level (0-7) 0002H 

(CN) Timer Counter Number (0,1,2) OOOOH 

(Cl) Clock Interval (O-OFFFFH msec) OOOAH 

■ (CF) Clock Frequency (O-OFFFFH khz) 04CDH 

(TPS) Timer Port Separation f O-OFFH) 0002H 

(NPX) Numeric Processor Extension (Yes/No) Yes 
(NIL) NPX Interrupt Level (Encoded) 0008H 


Memory 

Type : RAM = low, high 
Type : ROM = low, high 
Type : RAM = 0500H, F7FFH 


8-12 



******* LAB FOUR (BIOS CONFIG THROUGH ICU) ******* 


Sub-systems 

(UDI) Universal Development Interface (Yes/No) No 

(HI) Human Interface (Yes/No) No • 

(AL) Application Loader (Yes/No) No 

(EIO) Extended I/O System. (Yes/No) ' No 

(BIO) Basic I/O System (Yes/No) Yes 

(DB) . Debugger (Yes/No) No 

(TH) Terminal Handler (Yes/Nol No 

(CA) Crash Analyzer f Yes/No) No 

fUIR) UDI in ROM (Yes/No) No 

(CAR) Crash Analyzer in ROM f Yes/No) No 

(RIR) Root Job in ROM (Yes/No) No 


BIOS 

(ASC) All Sys Calls in BIOS (Yes/No) Yes 

(ADP) Attach Device Task Priority M-OFFH) 0081H 

fTF) Timing Facilities Required ^Yes/No) Yes 

(TTPl Timer Task Priority (O-OFFHl 0081H 

(CON) Connection Job Delete Priority (O-OFFH) 0082H 

(ACE) Ability to Create Existing Files (Yes/No) Yes 

(SMI) System Manager ID (Yes/No) Yes 

(CUT) Common Update Timeout (O-OFFFFH) 03E8H 

(CST) Control -Sequence Translation f Yes/No) Yes 

fPMI) BIOS Pool Minimum f O-OFFFFH) OCOOH 

(PMA) BIOS Pool Maximum (O-OFFFFH) OCOOH 

(BIR) Basic I/O System in ROM (Yes/No) No 


Jser Devices 

'OPNl Object Code Path Name (1-45 characters) 

:LAB:DEVDRV.OBJ 

'DPNl Duib Source Code Path Name (1-45 characters) 

:LAB:LBOXDUIB.SRC 

(DUP) Device and Unit Source Code Path Name (1-^5 characters) 

:LAB:LBOXDUIT.SRC 

'ND) Number of User Defined Devices (O-OFFH)' . OOOIH 

(NDU) Number of User Defined Device-Units (O-OFFHl 0002H 
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******* LAB FOUR fBlOS CONFIG THROUGH ICU) ******* 


Nucleus 

(ASC) All $ys Calls fYes/No) Yes 

(PV) Parameter Validation (Yes/Nol Yes 

(ROD) Root Object Directory Size (0 - OFFOh) 0028H 

(MTS) Minimum Transfer Size (O-OFFFFH) 0040H 

(DEH) Default Exception Handler (Yes/No/Deb/Use) Yes 
(NEH) Name of Ex Handler Object Module (l-32chs) 

(EM) Exception Mode (Never/Program/Environ/Al 1 ) Never 
(NR) Nucleus in ROM (Yes/No) No 


***** THIS JOB IS SUPPLIED TO CALL THE (BIOS) **** 


User Jobs 

(ODS) Object- Directory Size (O-OFFOH) 0032H 

(PMI) Pool Minimum (20H - OFFFFH) OlOOH 

(PMA) Pool Maximum (20H - OFFFFH) FFFFH 

rMOB) Maximum Objects (1 - OFFFFH) • FFFFH 

(MTK) Maximum Tasks (1 - OFFFFH) FFFFH 

(MPR) Maximum Priority fO - OFFH) OOOOH 

(AEH) Address of Exception Handler (CS:IP) 0000H:0000H 

(EM) Exception Mode (Never/Proq/Environ/All) Never 

(PV) Parameter Validation (Yes/No) Yes 

(TP) Task Priority fO-OFFH) 009BH 

(TSA) Task Start Address fCS:IP) 0104H:0002H 

DSB Data Segment Base (O-OFFFFH) OOOOH 

(SSA) Stack Segment Address (SSiSP) 0000H:0000H 

(SS) Stack Size fO-OFFFFH) - 0200H 


(NPX) Numeric Processor Extension Used (Yes/No) No 


***** THIS JOB SUPPLIES THE INTERRUPT FOR THE MONITOR **** 


User Jobs 

(ODS) Object Directory Size (O-OFFOH) OOOAH 

fPMI) Pool Minimum (20H - OFFFFH) 0030H 

(PMA) Pool Maximum (20H - OFFFFH) FFFFH 

(MOB) Maximum Objects (1 - OFFFFH) FFFFH 

(MTK) Maximum Tasks (1 - OFFFFH) FFFFH 

(MPR) Maximum Priority (0 - OFFH) OOOOH 

(AEH) Address of Exception Handler (CS:IP) OOOOHrOOOOH 

(EM) Exception Mode (Never/Prog/Environ/All) Never 

(PV) Parameter Validation (Yes/No) Yes 

(TP) Task Priority (O-OFFH) OOOOH 

(TSA) Task Start Address (CS:IP) 0080H:0002H 

(DSB) Data Segment Base (O-OFFFFH) OOOOH 

(SSA) Stack Segment Address (SS:SP) OOOOHrOOOOH 

(SS) Stack Size (O-OFFFFH) 0200H 


(NPX) Numeric Processor Extension Used (Yes/No) No 
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******* LAB FOUR (BIOS CONFIG THROUGH ICU) ******* 


Includes and Libraries 
Path Name (1-45 Characters) 

(UDF) UDI Includes and Libs 

/RMX5.0/DUDI/ 

(HIF) Human Interface Includes and Libs 

/RMX5.0/DINCLSLIBS/ 

(EIF) Extended I/O System Includes and Libs ' 

/RMX5.0/DINCLSLIBS/ 

(ALF) Application Loader Includes and Libs 

/RMX5.0/DL0ADER/ 

(BIF) Basic I/O System Includes and Libs 

/RMX5.0/DINCLSLIBS/ 

(THF) Terminal Handler and Debugger Includes and Libs 

/RMX5.0/DDEBTH/ 
fNUF) Nucleus and Root Job Includes and Libs 

/RMX5.0/DNUCLUS/ 

(ILF) Interface Libraries 

/RMX5.0/DUTILS/ 

(CAF) Crash Analyzer Includes and Libs 

/RMX5.0/DUDI/ 

(DTF) Development Tools Path Names 

/LANG/ 

Senerate File Names 
-ile Name (1-55 Characters) 

(ROF) ROM Code File Name 

: LAB: NONE 

(RAF) RAM Code File Name 

:LAB:RMX86 

STEP4: 

AFTER YOU ENTER ALL OF THE SCREENS ENTER G TO GENERATE 
EXIT THE ICU 

SUBMIT THE ICU.CSD FILE TO GENERATE YOUR SYSTEM 
-SUBMIT :LAB: ICU.CSD 
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******* LAB FOUR (BIOS CONFIG THROUGH ICU) ******* 


STEPS: 


YOU MUST NOW ADD THE USER JOB , AND- THE SDB TO THE SYSTEM, 
USING THE LIB86 UTILITY 



-LIB86 



DELETE 

:LAB:RMX86(STARTM0D) 


ADD 

:LAB:LABJOB to :LAB:RMX86 


DELETE 

:LAB:RMX86fINT3TASKM0D) 


ADD 

/DINT3/INT3J0B to :LAB:RMX86 

STEP6: 

EXIT 

• 


YOU ARE NOW READY TO "BOOT" YOUR NEWLY CREATED SYSTEM 

IF YOUR EXECUTION VEHICLE IS THE SAME AS THE DEVELOPMENT STATION 
THEN: 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 
-BOOT THE NEW SYSTEM 
.B /"TEAM NAME'7LAB3/RMX86 

IF YOUR EXECUTION VEHICLE DIFFERS FROM THE DEVELOPMENT STATION 
THEN: 

-COPY THE NEWLY CREATED BOOTABLE SYSTEM INTO A FLOPPY, 
f COPY :LAB:RMX86 OVER :FD0:RMX86 ) 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

-BOOT THE NEW SYSTEM 

.B /RMX86 

* THE 957 DEBUG MONITOR IS PRESENT AND CAN BE USED TO DEBUG 
YOUR CODE IF NESSESARY. PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 
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STEPS IN BUILDING THE EXTENDED I/O SYSTEM 

1) THREE CONFIGURATION FILES ARE NEEDED (ETABLE. A86.EDEVCF.A86. 
EJ0BCF.A86) 

2) ASSEMBLE EACH CONFIGURATION TABLE 

3) LINK AND LOCATE THE El OS 


EDEVCF 


EJOBCF 


ASSEMBLER 


LOCATE 


• ETABLE CONTAINS SYSTEM CALLS 

t EDEVCF CONTAINS DEVICES TO 
BE LOGICALLY ATTACHED BY 
EIOS 

• EJOBCF CONTAINS DESCRIPTION 
OF CHILD 10 JOBS 

• REFER TO CONFIGURATION 
MANUAL THROUGH THE REST 
OF THIS CHAPTER 



ETABLE.A86 


%RQCREATE lOJOB _ 

%RQEXIT 10 JOB 

%RQLOGICALATTACHDEVICE- 

%RQLOGICALDETACHDEVICE- 

%RQSCREATEFILE . 

$RQATTACHFILE 

%RQDELETECONNECTION ^ 

%RQLOOKUPCONNECTION 

XRQCATALOGCONNECTION 

%RQUNCATALOGCONNECTION 

55RQSCREATED I RECTORY 

%RQSDELETEFILE 

%RQSRENAMEFILE 

%RQSCHANGEACCESS 

%RQSOPEN 

%RQSCLOSE 

%RQSOPEN 

%RQSREADMOVE 

%RQSWRITEMOVE 

%RQSSEEK 

%RQSTRUNCATEFILE 
%RQSGETFILESTATUS 
%RQS GETCONNECT I ONSTATUS ‘ 
%RQSSPECIAL 


•JOB INTERFACE 


:ONFIGURATION INTERFACE 


SYNCHRONOUS INTERFACE 
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EDEVCF.A86 


j BYTE-BUCKET 


%DEV_I NFO_BLOCK ( ' BB ' / BB ' . PHYS I CAL) 
j TERMINAL 

%DEV_INFO_BLOCK( 'TO. 'TO '.PHYSICAL) 

; ‘ 215 WINCHESTER - PRlAM. UNIT 0. DRIVE 0 
%DEV INFO BLOCK! 'WD0'.' I W0'. NAMED ) ^ 


LOGICALLY ATTACH 


; 215 WINCHESTER FLOPPY DS/DD. UNIT 0. DRIVE 0 = 

%DEV- I NFO-BLOCK! ' FD0. 'WFDD0. NAMED ) 

; STREAM 

%DEV-INFO-BLOCK( 'STREAM' . 'STREAM' .STREAM) 


%DEV- I NFO-BLOCK( ' STREAM ' . ' STREAM ' . STREAM ) 
%END DEV CONFI 6(1024) 
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LOCATE ADDRESSES 


• THE LOCATE PROGRAM GENERATES A MAP FILE CALLED /RMX/DEI0S/EI0S.MP2 

r EXAMINING THE MAP WE OBTAIN THE ENDING ADDRESS OF THE EIOS 
(USED FOR LOCATING THE NEXT JOB) 


MEMORY MAP OF MODULE EIOENT 
SEGMENT MAP 


START 

STOP 

LENGTH 

ALIGN 

NAME 

CLASS 

mQw 

00216H 

0017H 

A 

(ABSOLUTE) 


182B0H 

1D0D7H 

2E28H 

W 

CODE 

CODE 

1D0D8H 

1D0DFH 

0008H 

W 

JOB.SEG 

CODE 

1DOE0H 

1D117H 

0038H 

W 

SYNCHRONOUS_SE 

CODE 

1D118H 

IDllBH 

0004H 

W 

•o 

CONFIGURATION, 

CODE 





-SEG 


IDllCH 

1D129H 

000EH 

W 

GROUPUSER_SEG 

CODE 

1D12AH 

1D133H 

000AH 

W 

ALLOCATION_SEG 

CODE 

lD13i|H 

1D143H 

0010H 

W 

DATA 

DATA 

1D150H 

1D150H 

0000H 

G 

??SEG 


1D150H 

1D150H 

0000H 

W 

STACK 

STACK 

- 

1D150H 

0000H 

W 

MEMORY 

MEMORY 


V ^ 


THE SUBMIT FILE (86/330 STYLE) 

ASM86 /RMX/DEI0S/ETABLE330.A86 PRINT(/RMX/DEIOS/ETABLE330.LST) 8 
WORKF 1 LES ( : WORK: , : WORK : ) OBJECT ( /RMX/DEI OS/ET ABLE . OBJ ) 

ASM86 /RMX/DEIOS/EDEVCF330 .A86 PRINT(/RMX/DEIOS/EDEVCF330. LST) 8 
W0RKF1LES(:W0RK: . :WORK: ) OBJECT (/RMX/DEIOS/EDEVCF. OBJ) 

ASM86 /RMX/DE1OS/EJOBCF330.A85 PRINT(/RMX/DE10S/EJ0BCF333.LST) 8 
W0RKFILES(:W0RK:,:W0RK:) 0BJECT(/RMX/DEI0S/EJ0BCF.0BJ) 

; LINK AND LOCATE EIOS INITIALIZATION CODE AND SYSTEM CALLS 

LINK86 8 

/RMX/DEIOS/EIOS.LIB(EIOENT), 8 
/RMX/DEIOS/ETABLE.OBJ, 8 

/RMX/DEIOS/EDEVCF. OBJ, 8 

/RMX/DEIOS/EJOBCF.OBJ, 8 

/RHX/DEIOS/EIOS.LIB, 8 

/RMX/DEIOS/EPIFC.LIB, 8 

/RMX/DBIOS/IPIFC.LIB, 8 

/RMX/DNUCLUS/RPIFC.LIB 8 

TO /RMX/DEIOS/EIOS.LNK 8 

MAP PRINT(/RMX/DEI0S/EI0S.MP1)8 
NOPUBLICS EXCEPT(RQEIOSINinASK, RQEIOSINITERROR) 


L0C86 8 

/RMX/DEIOS/EIOS.LNK TO /RMX/DEI OS/E I OS 
MAP PRINT(/RMX/DEI0S/EI0S.MP2) 8 
NOLINES NOCOMMENTS NOSYMBOLS 8 
SEGSIZE(STACK(0)) 8 

ORDER(CLASSES(CODE, DATA)) s 
ADDRESSES (CLASSES (CODE(0%1) ) ) 
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ROOT JOB MACRO 



• REMEMBER TO ADD A %JOB MACRO TO YOUR ROOT JOB 



EIOS JOB 




%JOB(10. 

OBJECT DIRECTORY SIZE 



0150H. 0FFFFH. 

%'POOL SIZE (MIN . MAX) 



0FFFFH. 0FFFFH 

. %'MAX OBJECTS AND TASKS 



130 > 

%'MAX JOB PRIORITY 



0:0. 3. 

EXCEPTION HANDLER ADDR, MODE 



0. 

%'JOB FLAGS 



150. 

Z'INIT TASK PRIORITY 



1A2B-.0. 

%'INIT TASK ENTRY ADDRESS 



0. 

%'INIT DATA SEGMENT ADDRESS 



0:0. 250H. 

%'INIT TASK STACK ADDRESS, STACK SIZE 



0) 

%'INIT TASK FLAGS 








ICU 86 

ICU86 WILL 

- CREATE ETABLE. EDEVCF AND EJOBCF 

- CREATE A SUBMIT FILE THAT INCLUDES ASSEMBLY 
LINKING AND LOCATION OF THE El OS 

- ADD A JOB MACRO TO THE ROOT JOB 

- COMPUTE THE STARTING ADDRESS OF THE EIOS 
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*★*★★★* lab five (BIOS CONFIG THROUGH ICU) ******* 

IBJECTIVES: 

EXECUTE A GIVEN APPLICATION JOB, THAT WILL CALL UPON THE EIOS TO 
COMMUNICATE WITH A TERMINAL AND A FILE IN A FLOPPY 

THE STUDENT WILL BUILD UPON LAB TWO TO CONFIGURE ALL THE 
PARTS NESSESARY TO EXECUTE THAT LAB 

THE STUDENT WILL USE THE INTERACTIVE CONFIGURATION UTILITY (ICU) 

;tepi: 

. USE THE ATTACH$FILE COMMAND TO ATTACH THE DIRECTORY NAMED (/"TEAM NAME"/LAB2) 
AS THE LOGICAL NAME (:LAB:) 

- AFILE /"TEAM NAME"/LAB2 AS :LAB: 

* FOR THE REST OF THIS LAB WE WILL USE THIS LOGICAL NAME * 
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******* LAB FIVE (EIOS CONFIG THROUGH ICU) ******* 

STEP2: 

THE (ICU) IS INVOKED BY TYPING THE FOLLOWING 
-ICU86 :LAB:ICU.DEF 

* WHERE ICU.DEF IS THE NAME OF THE FILE WE HAVE CHOSEN TO CONTAIN 
THE INFORMATION NEEDED TO CONFIGURE OUR O.S. 

WHEN THE ICU SIGN ON ENTER THE COMMAND C , TO MODIFY THE SCREENS 

STEPS: 


* TRY FILLING THE SCREENS WITHOUT LOOKING AT THESE FIRST, 
THEN MATCH YOUR ENTRIES TO THE ONES GIVEN HERE 

. * IF YOU- DO NOT UNDERSTAND AN ENTRY TYPE ? 

- E.G. OSP?<6r> 

* THE SCREEN FOR OUR LAB TWO CONFIGURATION FOLLOW 
Hardware 

(OSP) 80130 Operating System Extension (Yes/No) No 


(OTU) 80130 Timer Used (Yes/No) No 

(OPU) 80130 PIC Used (Yes/No) No 

(OCD) 80130 Copyright = 1981 f Yes/No) Yes 

(BL) 80130 Base Address Location (40h-0FFFFh) OOOOH 

(BP) 80130 Base Port Address fO-OFFFFH) OOOOH 

(MP) 8259A Master Port fO-OFFFFH) OOCOH 

(MPS) Master PIC Port Separation (O-OFFH) 0002H 

(SIL) Slave Interrupt Levels fl-7/None) None 

(LSS) Level Sensitive Slaves (1-7/None) None 

(LSP) Local Slave PICS (1-7/None) None 

(TP) 8253 Timer Port, (O-OFFFFH) OODOH 

(CIL) Clock Interrupt Level (0-7) 0002H 

(CN) Timer Counter Number (0,1,2) OOOOH 

(Cl) Clock Interval (O-OFFFFH msec) OOOAH 

(CF) Clock Frequency TO-OFFFFH khz) 04CDH 

(TPS) Timer Port Separation (O-OFFH) 0002H 

(NPX) Numeric Processor Extension (Yes/No) Yes 
(NIL) NPX Interrupt Level (Encoded) 0008H 
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******* LAB FIVE (EIOS CONFIG THROUGH ICU) ******* 


'lemory 

fype : RAM = low, high 
Fype : ROM = low, high 
Fype : RAM = 0500H, F7FFH 


Sub-systems 

(UDI) Universal Development Interface (Yes/No) No 


fHIl Human Interface (Yes/Nol No 
(AL) Application Loader (Yes/No) No 
(EIO) Extended I/O System fYes/No) Yes 
fBIO) Basic I/O System (Yes/No) Req 
(DB) Debugger (Yes/No) No 
(TH) Terminal Handler fYes/No) No 
(CA) Crash Analyzer (Yes/No) No 
(UIR) UDI in ROM (Yes/No) No 
fCAR) Crash Analyzer in ROM fYes/No) No 
(RIR) Root Job in ROM fYes/No) No 


IIOS 

fASC) All Sys Calls in EIOS 

fABR) Automatic Boot Device Recognition (Yes/No) 

(DLN) Default System Device Logical Name fl-12 characters) 
fDPN) Default System Device PhysicaT Name fl-12 characters) 
fDFD) Default System Device File Driver f Phys/Str/Named) 
fDO) Default System Device Owners ID fO-OFFFFH) 

[EBS) Internal Buffer Size fO-OFFFFh) 

[DDS) Default 10 Job Directory Size (5-OFFOh) 

[ITP) Internal EIOS Task's Priorities fO-OFFH) 

^PMI) EIOS Pool Minimum fO-OFFFFH) 

[PMA) EIOS Pool Maximum fO-OFFFFH) 

^EIR) Extended I/O System in ROM (Yes/No) 


Yes 

No 


Named 

OOOOH 

0400H 

0020H 

0083H 

0180H 

FFFFH 

No 
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******* 


LAB FIVE fEIOS CONFIG THROUGH ICU) 


******* 


I/O Users 

User : user name,Owner-ID (, ID, ID, ID, ID) 
User : LAB2,0000H,FFFFH 


Logical Names 

Logical Name : logical_name,device__name,f ile_driver,owners-id 

fl-12 Chars ,1-14 Chars , Physical/Stream/Named, O-OFFFFH) 
Logical Name : BB, BB, Physical, OOOOH 
Logical Name : STREAM, STREAM, Stream, OOOOH 
Logical Name : TO, TO, Physical, OOOOH 
Logical Name : FDO, WFDDO, Named, OOOOH 


I/O Jobs 

(IJD) I/O Job Default Prefix (Logical Name) 

(DU) Default User (I/O User) 

(PMI) Pool Minimum (20H - OFFFFH) 

(PMA) Pool Maximum (20H - OFFFFH) 

(AEH) Address of Exception Handler (CSrIP) 

(EM) Exception Mode (Never/Prog/Environ/All) 
(PV) Parameter Validation (Yes/No) 

(TP) Task Priority (O-OFFH) 

(TSA) Task Start Address (CS:IP) 

(DSB) Data Segment Base (O-OFFFFH) 

(SSA) Stack Segment Address (SS:SP) 

SS) Stack Size (O-OFFFFH) 

(NPX) Numeric Processor Extension Used (Yes/No) 


TO 

LAB2 

0260H 

FFFFH 

OOOOH: OOOOH 
Never 
Yes 
009BH 

0104H:0002H 

OOOOH 

OOOOH: OOOOH 

0300H 

No 


BIOS 

(ASC) All Sys calls in BIOS (Yes/No) Yes 

(ADP) Attach Device Task Priority (1-OFFH) 0081H 

(TF) Timing Facilities Required (Yes/No) Yes 

(TTP) Timer Task Priority (O-OFFH) 0081H 

(CON) Connection Job Delete Priority (O-OFFHl 0082H 

(ACE) Ability to Create Existing Files (Yes/No) Yes 

(SMI) System Manager ID (Yes/No) Yes 

(cut) Common Update Timeout (O-OFFFFH) 03E8H 

(CST) Control-Sequence Translation (Yes/No) Yes 

(PMI) BIOS Pool Minimum (O-OFFFFH) OCOOH 

(PMA) BIOS Pool Maximum (O-OFFFFHl OCOOH 

(BIR) Basic I/O System in ROM (Yes/No) No 


9-12 



******* LAB FIVE fEIOS CONFIG THROUGH ICU) ******* 


Intel Terminal Driver 

(IILl Input Interrupt Level ^Encoded) 0068H 

(OIL) Output Interrupt Level fEncodedl 0078H 

(UDP) USART Data Port (O-OFFFFHl 00D8H 

(USP USART Status Port (O-OFFFFH) OODAH 

(IRP) 8253 Input Rate Port (O-OFFFFH) OODAH 

(ICP) 8253 Input Control Port f O-OFFFFH) 00D6H 

(iRC) 8253 Input Counter Number (0-2) 0002H 

(IRM) Input Rate Maximum f O-OFFFFFFFFH) . 00012C00H 

fORP) 8253 Output Rate Port (O-OFFFFH) OOOOH 

(OCP) 8253 Output Control Port (O-OFFFFH) OOOOH 

(ORC) 8253 Output Counter Number fO-2) OOOOH 

fORM) Output Rate Maximum f O-OFFFFFFFFH) OOOOOOOOH 


Intel Terminal Driver Unit Information 
(NAM) Unit Info Name (1-17 Chars) tO_uinfo 

(LEM) Line Edit Mode (Trans/Normal/Flush) Normal 

(ECH) Echo Mode (Yes/No) Yes 

(IPC) Input Parity Control (Yes/No) No - 

(OPC) Output Parity Control (Yes/No) No 

(OCC) Output Control in Input (Yes/No) Yes 

(OSC) OSC Controls (Both/In/Out/Neither) Both 

(DUP) Duplex Mode (Full/Half) Full 

(TRM) Terminal Type (CRT/Hard Copy) CRT 

(mC) Modem Control (Yes/No) No 

(RPC) Read Parity Checking (See Help/0-3) OOOOH 

(WPC) Write Parity Checking (See Help/0-4) OOOOH 

(BR) Baud Rate (O-OFFFFH) 2580H 

(SN) Scroll- Number (O-OFFFFH) 0012H 


Intel Terminal Driver Device-Unit Information 
(NAM) Device-Unit Name (1-13 chars) 

(UN) Unit Number on this Device (O-OFFH) 
(UIN) Unit Info Name (1-17 Chars) 

(MB) Max Buffers (O-OFFH) 


TO 

OOOOH 

tO_uinfo 

OOOOH 
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******* LAB FIVE (EIOS CONFIG THROUGH ICU) ******* 


Intel iSBC 215/218 Driver 

(IL) Interrupt Level (Encoded Level) 0058H 
(ITP) Interrupt Task Priority fO-OFFH) 0082H 
(WIP) Wakeup I/O Port fO-OFFFFH) OlOOH 


Intel iSBC 215/218 Unit Information 
(NAM) Unit Info Name (1-17 Chars) 

(MR) Maximum Retries (O-OFFFFH) 

(CS) Cylinder Size (O-OFFFFH) 

(NC) Number of Cylinders (O-OFFFFH) 

(NFH) Number of Fixed Platters/Disk fO-OFFHl 
(NRH) Number of Remove Platters/Disk fO-OFFH) 
(NS) Number of Sectors/Track (O-OFFFFH) 

(NAC) Number of Aux. Cylinders fO-OFFHl 
(SSN) Starting Sector Number (O-OFFFFFFFFH) • 
(BTI) Bad Track Information (Yes/No) 


uinfo_215fd 

0009H 

OOOOH 

004DH 

OOOOH 

0002H 

001 AH 

OOOOH 

OOOOOOOOH 

Yes 


Intel iSBC 215/iSBX 218 Device-Unit Information 
(NAM) Device-Unit Name (1-13 chars! 

(PFD) Physical File Driver Required fYes/No) 

(NFD) Named File Driver Required (Yes/No) 

(SDD)- Single or Double Density Disks (Single/Double) 
(SDS) Single or Double Sided Disks fSingle/Double) 

(EFI) 8 or 5 Inch Disks (8/5) 

(GRA) Granularity fO-OFFFFH) 

(DSZ) Device Size fO-OFFFFFFFFH) 

(UN) Unit Number on this Device ^O-OFFH) 

(UIN) Unit Info Name (1-17 Chars) 

(UDT) Update Timeout (O-OFFFFH) 

(NB) Number of Buffers (nonrandom— 0/rand = 1-OFFFFH! 
(FUP) Fixed Update (True/False) 

(MB) Max Buffers (O-OFFH) 


WFDDO 

Yes 

Yes 

Double 

Double 

8 

OlOOH 

000F9700H 

0008H 

uinfo__215fd 

0064H 

0006H 

True 

OOFFH 


Nucleus 

(ASC) All Sys Calls TYes/No) Yes 

(PV) Parameter Validation (Yes/No) Yes 

(rod) Root Object Directory Size (0 - OFFOhl 0028H 
fMTS) Minimum Transfer Size (O-OFFFFH) 0040H 

(DEH) Default Exception Handler (Yes/No/Deb/Use) Yes 
(NEH) Name of Ex Handler Object Module (l-32chs) 

(EM) Exception Mode (Never/Program/Environ/All ) Never 
(NR) Nucleus in ROM f Yes/No) No 
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******* LAB FIVE fEIOS CONFIG THROUGH ICU) ******* 


Jser Jobs 

[ODS) Object Directory Size fO-OFFOH) OOOAH 

’PMI) Pool Minimum (?0H - OFFFFH) 0030H 

PMA) Pool Maximum f20H - OFFFFH) FFFFH 

MOB) Maximum Objects fl - OFFFFH) FFFFH 

;mTK) Maximum Tasks (1 - OFFFFH) FFFFH 

’MPR) Maximum Priority ^0 - OFFH) OOOOH 

’AEH) Address of Exception Handler (CSrIP) OOOOHrOOOOH 

'EM) Exception Mode f Never/Prog/Environ/All) Never 
[PV) Parameter Validation f Yes/No) Yes 

[TP) Task Priority fO-OFFH) OOOOH 

;tSA) Task Start Address (CS:IP) 0080H:0002H 

[DSB) Data Segment Base (O-OFFFFH) OOOOH 

[SSA) Stack Segment Address fSS:SP) OOOOHrOOOOH 

;ss) stack Size (O-OFFFFH) 0200H 


[NPX) Numeric Processor Extension Used (Yes/No) No 


[ncludes and Libraries 
’ath Name (1-45 Characters) 

’UDF) UDI Includes and Libs 

/RMX5.0/DUDI/ 

HIF) Human Interface Includes and Libs 

/RMX5.0/DINCLSLIBS/ 

'EIF) Extended I/O System Includes and Libs 

/RMX5.0/DINCLSLIBS/ 

'ALF) Application Loader Includes and Libs 

/RMX5.0/DL0ADER/ 

BIF) Basic I/O System Includes and Libs 

/RMX5.0/DINCLSLIBS/ 

THF) Terminal Handler and Debugger Includes and L^bs 

/RMX-5.0/DDEBTH/ 

NUF) Nucleus and Root Job Includes and Libs 

/RMX5.0/DNUCLUS/ 

ILF) Interface Libraries 

/RMX5.0/DUTILS/ 

CAF) Crash Analyzer Includes and Libs 

/RMX5.0/DUDI/ 

DTF) Development Tools Path Names 

/LANG/ 


jenerate File Names 

;ile Name (1-55 Characters) 

ROF) ROM Code File Name 

: LAB: NONE 

RAF) RAM Code File Name 

:LAB:RMX86 
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STEP4: 


******* LAB FIVE (EIOS CONFIG THROUGH ICU) ******* 

AFTER YOU ENTER ALL OF THE SCREENS ENTER G TO GENERATE 
EXIT THE ICU 

SUBMIT THE ICU.CSD FILE TO GENERATE YOUR SYSTEM 
-SUBMIT :LAB: ICU.CSD 

STEPS: 

YOU MUST NOW ADD THE USER JOB AND THE SDB TO THE SYSTEM, 

USING THE LIB86 UTILITY 

-LIB86 

DELETE : LAB : RMX86 ( STARTMOD ) 

ADD :LAB:LABJOB to :LAB:RMX86 

DELETE :LAB:RMX86fINT3TASKMOD) 

ADD /DINT3/INT3J0B to :LAB:RMX86 

EXIT 

STEPS: 

YOU ARE NOW READY TO "BOOT" YOUR NEWLY CREATED SYSTEM 

IF YOUR EXECUTION VEHICLE IS THE SAME AS THE DEVELOPMENT STATION 
THEN: 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 
-BOOT THE NEW SYSTEM 
.B /"TEAM NAME"/LAB2/RMX86 

IF YOUR EXECUTION VEHICLE DIFFERS FROM THE DEVELOPMENT STATION 
THEN: 

-COPY THE NEWLY CREATED BOOTABLE SYSTEM INTO A FLOPPY. 

( COPY :LAB:RMX86 OVER :FD0:RMX86 ) 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

-BOOT THE NEW SYSTEM 

.B /RMX86 

* THE 957 DEBUG MONITOR IS PRESENT AND CAN BE USED TO DEBUG 
YOUR CODE IF NESSESARY. PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 
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CHAPTER 10 

THE IRMX 86 APPLICATION LOADER 

t LOADER FUNCTION 

• TYPES OF LOADABLE CODE 

• SYSTE.^S WITHOUT THE EIOS 

. • LOADER RESULT SEGMENT 

• SYSTEMS WITH THE EIOS 


J 



APP LOADER FUNCTION 


• THE APP LOADER MOVES CODE FROM SECONDARY STORAGE INTO RAM 


O o 



NAMED FILES 

• THE APP LOADER CAN LOAD OBJECT CODE FROM ANY DEVICE 
THAT SUPPORTS iRMX 86 NAMED FILES 

t THE iRMX 86 O.S. IS CURRENTLY DELIVERED WITH SUPPORT 
FOR THE FOLLOWING DEVICES 

ISBC 2Q^ ISBC 218 

ISBC 206 • ISBC 220 

ISBC 215 ISBC 25A 

• IT WILL ALSO SUPPORT CUSTOM DEVICES. FOR WHICH YOU 
HAVE WRITTEN A DEVICE DRIVER 
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TYPES OF- LOADABLE CODE 


t ABSOLUTE (ABS) 

- CODE IS LOCATED AT AN ABSOLUTE LOCATION IN MEMORY 
WITH THE L0C86 UTILITY PROGRAM 

- THE USER "MUST" HAVE THIS LOCATION RESERVED 
AT CONFIGURATION 

- THE LOADER ALWAYS LOADS THE CODE AT THE SAME 
ABSOLUTE LOCATION 


- PL/M MODELS MAY BE MEDIUM. LARGE OR COMPACT 




TYPES OF LOADABLE CODE (CONTINUED) 

• POSITION INDEPENDENT CODE (PIC) 

- CODE IS NEVER LOCATED. INSTEAD THE BIND OPTION IS USED 
WHEN LINKING WITH THE LINK86 UTILITY PROGRAM 

- PIC CODE CAN BE LOADED INTO ANY MEMORY LOCATION 

- THE LOADER OBTAINS iRMX 86 SEGMENTS "RUNTIME" AND 
LOADS PIC INTO THE SEGMENTS 

- PIC IS RESTRICTED TO USE BY TASKS THAT HAVE ONLY 
ONE CODE SEGMENT AND ONE DATA SEGMENT 


PL/M MODEL IS COMPACT ONLY 
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TYPES OF LOADABLE CODE (CONTINUED) 


• LOAD TIME LOCATABLE (LTD 

- SIMIUR TO PIC CODE. LINK WITH BIND. CODE MAY BE 
LOADED ANYWHERE IN MEMORY 

- CAN BE USED BY TASKS HAVING MORE THAN ONE CODE 
SEGMENT OR MORE THAN ONE DATA SEGMENT 

- PL/M MODELS MAY BE MEDIUM. LARGE OR COMPACT 
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SYSTEMS WITHOUT THE EIOS 


• THE APPLICATION LOADER LIVES IN YOUR SYSTEM AS 
A FIRST LEVEL JOB. 
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THE LOADER RESULT SEGMENT 

• THE LDRS IS RETURNED TO THE RESPONSE MAILBOX AFTER THE 
LOADER HAS COMPLETED THE LOAD FUNCTION. 


EXCEPT$CODE 


RECORD$COUNT 


RECITYPE 


NUMBER$UNDEFINED$REFS 


INIT$IP 


C0DE$SE6$BASE 


STACK$SEG$BASE 


STACK$OFFSET 


STACK$SEG$BASE 


STACK$SIZE 


CATA$SEG$BASE 


f THE LOADING TASK USES THE INFORATION IN THE LDRS TO 
CREATE A TASK OR CREATE A JOB. 




CODE ENTRY POINTS 

• THE ENTRY POINT IS WHERE EXECUTION BEGINS AFTER THE 
CODE IS LOADED. 

• THE LOADER MUST GET THIS ENTRY POINT FROM THE LOADABLE CODE. 

• THERE IS ONE CIRCUMSTANCE IN WHICH THE LOADER DOES NOT 
REQUIRE AN ENTRY POINT. 

- THE LOADABLE CODE IS ABSOLUTE. AND 

- THE LOADING TASK KNOWS THE ENTRY POINT. AND 

- THE LOADING TASK USES THE RQALOAD SYSTEM CALL 
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USING RQALOAD SYSTEM CALL 


MEDIUM 


COMPACT 


(NO INI- 


MAIN 

-SEGSIZE(STACK(?SO) ON UlC 86 

-LORS IS OK TO CREATE 
TASK OR JOB 


-SEGSIZE(STACK(j5«))ON L0C86 



PROCEDURE 

-MUST BE PLM URGE MODEL 


-USE START (PUBLIC SYMBOL) 
ON L0C86 

-USE DYNAMIC STACK.SIZE=512 
■SEGS I ZE (^ACK (2 ) )ONU)C86 





LOADABLE PROCEDURES 

f WRITE SOURCE CODE AS A PROCEDURE ONLY IF: 

- CODE IS (ABS). WITHOUT USING NOINITCODE IN L0C86 

- YOU ARE LOADING A TASK(S) AND NOT A JOB 

- YOU ARE USING THE RQALOAD SYSTEM CALL 

• PROCEDURE EXAMPLE 
FLASHMOD-.DO; 

$ INCLUDE (/RMX/DNUCLUS/NUCLUS . EXT) 

DECLARE STATUS WORD; 

FLASHTASK: PROCEDURE PUBLIC; 

DO FOREVER; 

OUTPUT (9CH) = 0FFH; 

CALL RQSLEEP(50. aSTATUS); 

OUTPUT (9CH) = 0; 

CALL RQSLEEP(5D. aSTATUS); 

END; /*END OF FOREVERV 
END; /'END OF TASK*/ 

END; /‘END OF MODULE*/ 
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LOADABLE MAIN MODULES 

• IF CODE IS LTL OR PIC THEN CODE MUSI BE A MAIN MODULE 

• A MAIN MODULE CONTAINS EXECUTABLE STATEMENTS AT THE ‘OUTERMOST 
LAYER OF THE MODULE 

• WHEN LINKING OR LOCATING USE "SEGSIZE(STACK(###) )" TO 
ASSIGN THE APPROPRIATE STACKSIZE 


• MAIN MODULE EXAMPLE 
FLASHMOD : DO; 

$I NCLUDE (/RMX/DNUCLUS/NUCLUS . EXT ) 
DECLARE STATUS WORD; 

DO FOREVER; 

OUTPUT (09CH) = 0FFH; 

CALL RQSLEEPC25. aSTATUS); 
OUTPUT (09CH) = 0; 

CALL RQSLEEP(25. aSTATUS); 
END; /‘END OF FOREVER*/ 

END; /*END OF MODULE*/ 
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SYNCHRONOUS LOADER SYSTEM CALL 

0 RQS LOAD 10 JOB 

- SYNCHRONOUS 

- LOADS CODE INTO MEMORY. STARTS NEW 10 JOB 

- THE FORM OF THE CALL IS 

JOB$TOKEN = RQSLOADIOJOB 0(10. FD0: FLASH' ) . 

0.0FFFFH. 

0 . 

0 . 

130. 

0 . 

RSPMBOX. 
aSTATUS); 


V y 


/•PATH PTR*/ 

/•POOL LOWER. UPPERS/ 
/•EXCEPT HANDLER*/ 
/•JOB FLAGS*/ 

/•TASK PRIORITY*/ 
/•TASK FLAGS*/ 
/•RESPONSE MAILBOX*/ 
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THE TERMINATION MESSAGE 

• WHEN THE NEWLY CREATED 10 JOB MAKES AN RQEXITIOJOB CALL 

- THE PARENT JOB RECEIVES A TERMINATION MESSAGE 

- THE PARENT JOB WAITS AT THE RSPMBOX FOR THIS MESSAGE 

- THE FORMAT OF THE MESSAGE IS 



TERMINATION CODE 
USER$FAULT$CODE 
JOB$TOKEN 

data$lenI 

DATA(*) 


• REFER TO RQCREATEIOJOB IN EIOS REFERENCE MANUAL. 
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STEPS IN BUILDING THE APPLICATION LOADER 

1) A CONFIGURATION FILE IS NEEDED (LC0NFG.P86) 

2) COMPILE (PLM86) THE CONFIGURATION FILE 

3) LINK AND LOCATE THE APP LOADER 



ALTER LC0NFG.P86 


• REFER TO CONFIGURATION 
GUIDE THROUGH THE REST 
OF THIS CHAPTER 



LOADERSCONFIG: DO; 

DECLARE BUF$SIZE 
DECLARE RDBUF$SIZE 

DECLARE LBUF$SIZE 
DECLARE L$RDBUF$SIZE 


LC0NFG.P86 


LITERALLY '1024'; /* BYTES */ 
LITERALLY '1024'; /* BYTES */ ^ 

WORD PUBLIC DATA(BUF$SIZE + 11); 
WORD PUBLIC DATA(RDBUF$SIZE); 


THE SIZE OF THE 
LOADER INTERNAL 
BUFFERS FOR OBJECT 
RECORDS. 

THE SIZE OF THE 
INPUT BUFFERS 


DECLARE$DEFAULT$MEMPOOL WORD PUBLIC DATA(200H); /'PAGES*/ 
END LOADER$CONFIG; \ 


L$DEFAULT$MEMPOOL SELECTS THE DYNAMIC MEMORY 
(MEMPOOL) REQUIREMENT FOR THE OBJECT-FILE 
BEING LOADED. 

NOTE: THIS VALUE IS SPECIFIED IN PAGES 
(1 PAGE = 16 BYTES). 

THIS PARAMETER HAS NO EFFECT ON 
'RQ$A$LOAD' SYSTEM CALL. 
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THE SUBMIT FILE (86/330 STYLE) 


PLM86 /RMX/DLOADER/LCONFG330.P86 COMPACT 0PTIM1ZE(3) NOTYPE ROM & 

OBJECT ( /RMX/DL0ADER/LC0NF6 . OBJ ) PRI NT ( /RMX/DLOADER/LCONFG330 . 1ST ) WORKF I LES ( : WORK : . : WORK : ) 

"CONFIGURATION- PARAMETER 2 
A - ABSOLUTE 
P - ABSOLUTE + PIC 
L - ABSOLUTE + PIC + LTL 
0 - ABSOLUTE + PIC + LTL WITH 
OVERLAYS 

"CONFIGURATION PARAMETER 3 
N - NO LOAD-JOB FUNCTION 
A - ASYNCHRONOUS LOAD- JOB FUNCTION 
S - ASYNCHRONOUS + SYNCHRONOUS LOAD- 
JOB FUNCTION 

NOPUBLICS EXCEPTIRQLOADERINIHASK, RQLOADERINITERROR) 

L0C86 /RMX/DLOADER/LOADER.LNK TO /RMX/DLOADER/LOADER 8 
MAP PRINT(/RMX/DL0ADER/L0ADER.MP2) 8 
NOLINES NOCOMMENTS NOSYMBOLS 8 
ORDER (CLASSES (CODE, DATA)) 8 
SE6SIZE(STACK(0), DATA(_2)) _ 8 

ADDRESSES ( CLASSES (CODE<%ITt > - — ADDRESS 

•SUBMIT /RMX/DLOADER/LOADER (DATE, LOC.ADR, CP2, CP3) 
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LINK86 /RMX/DL0ADER/L0ADR||)ILIB{LDR1NT), 8^ 

/RMX/DL0ADER/LC0NF6 . 

/RMX/DLOADER/LOADI©rCJB(LDRENT), 8 
/RMX/DLOADER/LJBC^|U^, 
/RMX/DLOADER/LOADI©. 


/RMX/DEIOS/EPIFC.LIB, 
/RMX/DBIOS/IPIFC.LIB, 
/RMX/DNUCLUS/RPIFC.LIB 
TO /RMX/DLOADER/LOADER.LNK 
PRI NT ( /RMX/DLOADER/LOADER . MPl ) 



LOCATE ADDRESSES 

• THE L0C86 PROGRAM GENERATES A MAP FILE CALLED 
/RMX/DLOADER/LOADER .MAP 

• EXAMINING THE MAP WE OBTAIN THE ENDING ADDRESS OF THE LOADER 
(USED FOR LOCATING THE NEXT JOB) 


MEMORY MAP OF MODULE LDRINT 
SEGMENT MAP 


START 

STOP 

LENGTH ALIGN 

NAME 

CLASS 

mQQH 

00216H 

0017H 

A 

(ABSOLUTE) 


1D15(?H 

1F432H 

22E3H 

W 

CODE 

CODE 

mm 

1F441H 

0002H 

G 

DATA 

DATA 

1F450H 

1F450H 

0000H 

G 

??SEG 


1F450H 

1F450H 

0000H 

W 

STACK 

STACK 

<F45^ 

1F450H 

0000H 

W 

MEMORY 

MEMORY 
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DON'T FORGET ROOT JOB MACRO! 

# ADD A %JOB MACRO TO YOUR SYSTEM ROOT JOB 
i MUST BE BETWEEN lOS AND EIOS %JOB MACROS 


jAPP LOADER 


%JOB(0^ 

5 'OBJECT DIRECTORY SIZE 

20H.20H. 

%'POOL SIZE (MIN. MAX) 

50.5. 

%'MAX OBJECTS AND TASKS 

0. 

%'MAX JOB PRIORITY 

0! 0.0. 

%' EXCEPTION HANDLER. MODE 

0. 

%'JOB FLAGS 

130. 

%'INIT TASK PRIORITY 

1d15:0. • 

%'INIT TASK ENTRY 

0. 

%'INIT TASK DATA SEGMENT ADDRESS 

0.160. 

%'INIT TASK STACKADDRESS. STACKSIZE 

0) 

%'INIT TASK FLAGS 
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ICU86 


ICU86 WILL 


- CREATE LC0NFG.P86 

- CREATE A SUBMIT FILE THAT INCLUDES COMPILING 
LINKING AND LOCATING OF THE APP LOADER 

- ADD A JOB MACRO TO THE ROOT JOB 

- COMPUTE THE STARTING ADDRESS OF THE LOADER 
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******* LAB SIX (APR LOADER SYSTEM) ★★***★* 


)BJECTIVES: 

EXECUTE A STUDENT APP LOADER APPLICATION JOB IN AN RMX86 O.S. ENVIROMENT 

INTRODUCE (EIOS) SYSTEM CALLS: 

- RQ$S$LOAD$IO$JOB 

USE ICU TO BUILD A SYSTEM CONTAINING: 

- A NUCLEUS 

- A BIOS 

- AN EIOS 

- AN APPLICATION LOADER 

CREATE SOURCE CODE: 

- A SOURCE FILE NAMED START. P86 

- A SOURCE FILE NAMED LDRLAB.P86 

COMPILE (PLM86), LINK, AND LOCATE AN APPLICATION JOB, THAT WILL CALL UPON 
THE EIOS TO COMMUNICATE WITH A FILE IN A FLOPPY, CONTAINING A LOADABLE 
JOB, LOAD THE JOB AN EXECUTE 


THE LOADABLE JOB WILL CONTAIN A SIMPLE TASK THAT FLASHES THE LIGHTS IN 
THE LIGHT BOX 

;tepi : 

USE THE ATTACHSFILE COMMAND TO ATTACH THE DIRECTORY NAMED (/"TEAM NAMEVLAB6) 
AS THE LOGICAL NAME (:LAB:) ' 

- AFILE /"TEAM NAME"/LAB6 AS :LAB: 

* FOR THE REST OF THIS LAB WE WILL USE THIS LOGICAL NAME * 

UB 6 (l»*PT *) 



• USE TIC /IMPLICATION LO/IOER TO LO/ID A MAIN lOOULE (JOB). SYNCIKONOUSLY USING THE EIOS 

• TIC STUDENT HILL BE GIVEN THE NUClEUSTTIKi'TOS. SOB 

• THE STUDENT HILL SUPPLY APPLICATION. ROOT, LOADER AlO HILL BUILD AND PLACE FLASH JOB 
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******* 


LAB SIX (APR LOADER SYSTEM) ******* 


STEP2: 

BUILD A SYSTEM CONTAINING THE APPLICATION LOADER 

* WE WILL USE THE SYNCHRONOUS LOADER CALL TO LOAD AN 10 JOB FROM 
A FLOPPY INTO MEMORY 


* SINCE THIS REQUIRES THAT OUR SYSTEM INCLUDE THE EXTENDED 10, WE 
WILL USE THE SYSTEM WE ALREADY BUILT IN LAB FIVE. 

THE (ICU) IS INVOKED BY TYPING THE FOLLOWING 
-ICU86 /RII5.0/LAB5/ICU.DEF TO :LAB:ICU.DEF 

* WHERE ICU.DEF IS THE NAME OF THE FILE WE HAVE CHOSEN TO CONTAIN 
THE INFORMATION NEEDED TO CONFIGURE OUR O.S. 


WHEN THE ICU SIGN ON ENTER THE COMMAND C , TO MODIFY THE SCREENS 


APP LOADER SCREENS; 

Application Loader 

fIBS) Internal Buffer Size (0 - OFFFFh) 
(RBS) Read Buffer Size (0 - OFFFFh) 

(LJT) Load Job Type f None/Async/Sync) 

(DMP) Default Memory Pool Size (0 - OFFFFh) 
(CT) Code Type (Abs/Pic/Ltl/Ovr) 

(ALR) Application Loader in ROM (Yes/No) 


0400H 

0400H 


Synchronous and Asyncronous 
OlOOH 

Overlay, LTL, PIC and Abs 
No 


STEPS; 

AFTER YOU ENTER ALL OF THE SCREENS ENTER G TO GENERATE 
EXIT THE ICU 

SUBMIT THE ICU.CSD FILE TO GENERATE YOUR SYSTEM 
-SUBMIT ;LAB; ICU.CSD 
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******* LAB SIX (APP LOADER SYSTEM) 


******* 


STEP4: 

BUILD THE RESIDENT JOB 

MODIFY A SOURCE FILE IPARTIALLY SUPPLIED FOR YOU) NAMED :LAB:LDRLAB.P86 
WITH THE "ALTER" TEXT EDITOR 

- ALTER :LAB:LDRLAB.P86 

* THIS SOURCE FILE IS THE APPLICATION TASK THAT CONFORMS TO THE FOLLOWING 
FLOWCHART 

CREATE A RESPONSE MAILBOX 

LOAD THE JOB FROM :FDO:FLASHJOB 

CREATE FILE CONNECTION TO TERMINAL */* ?f4,':T0:') 

OPEN TERMINAL FILE */* fR/W) , SHARE ALL , *NOTE 

WRITE MESSAGE TO TERMINAL */* MESSAGE = "FILE HAS BEEN LOADED 

CLOSE TERMINAL FILE */* 

** DELETE SELF ** CALL EXIT$IO$JOB 
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******* LAB SIX fAPP LOADER SYSTEM) ******* 

STEPS: 

* ROOT JOBS ABSOLUTELY ADDRESS THE STARTING LOCATION OF THE STUDENT'S 
JOB CODE. THE ENTRY POINT MAY VARY IF INTERNAL PROCEDURES OR 
CHARACTER CONSTANTS ARE USED. 

FOR THIS REASON IT IS ADVISABLE TO CREATE AND LINK A START TASK TO 
THE REST OF THE APPLICATION CODE TO FIX THE ENTRY POINT'S OFFSET 
INTO THE CODE 

* THIS APPLICATION JOB WILL BE A SECOND LEVEL JOB. A TASK WITHIN THIS 
JOB IS NOT REQUIRED TO MAKE A CALL TO RQ$ENO$INIT$TASK, THE EIOS CODE 
SUPPLIES A TASK THAT CALLS RQ$ENO$INIT$TASK 

* IN ORDER TO DEBUG OUR CODE BEFORE IT "CRASHES" WE MAY WISH TO 
INVOKE THE 957 MONITOR AT THE START OF OUR JOB'S EXECUTION. 

THIS CAN EASILY BE ACCOMPLISHED BY PLACING A "CAUSE$INTERRUPTI3)" 
INSTRUCTION AT THE BEGINNING OF OUR CODE (IN OUR START TASK). 


* WE WILL USE THE SAME START TASK THAT WE USED IN LAB TWO 
-COPY /RII5.0/LAB2/START.P86 TO :LAB:START.P86 
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★*★★**★ 


LAB SIX (APP LOADER SYSTEM) ******* 


STEPS: 

COMPILE THE SOURCE FILES (START. P86 AND LDRLAB.P86) 

- PLM86 : LAB: START. P86 

- PLM86 :LAB:LDRLAB.P86 

* IF ANY ERRORS OCCURRED DURING COMPILATION , YOU MUST FIX AND 
RECOMPILE BEFORE CONTINUING 

* IF COMPILATION IS SUCCESFUL THE COMPILER WILL CREATE FOR EACH OF 
THE SOURCE FILES: 

- A LIST FILE named " :LAB : (SOURCE) .LST” 

- AN OBJECT FILE NAMED " :LAB : (SOURCE) .OBJ" 

LINK THE OBJECTS WITH THE INTERFACE LIBRARIES NEEDED (LARGE) 

LINK86 :LAB:START.OBJ,& 

:LAB:LDRLAB.OBJ,& 

/RMX5.0/DUTILS/EPIFL.LIB,& 

/RMX5.0/DUTILS/IPIFL.LIB,& 

/RMX5.0/DUTILS/LPIFL.LIB,& 

/RMX5.0/DUTILS/RPIFL.LIB & 

TO :LAB:JOB.LNK & 

NOMAP 

LOCATE THE LINKED MODULE TO AN ABSOLUTE ADDRESS 
L0C86 :LAB:JOB.LNK & 

TO :LAB:LABJOB & 

SC(3) SEGSIZE(STACK(0)) & 

ORDER ( CLASSES ( CODE , DATA , STACK ) ) & 

ADDRESSES ( CLASSES ( CODE ( 1040H) ) ) & 

NOINITCODE & 

OC(PURGE) 


YOU MUST NOW ADD THE USER JOB AND THE SDB TO THE SYSTEM, 
USING THE LIB86 UTILITY 

-LIB86 

DELETE : LAB : RMX86 ( STARTMOD ) 

ADD : LAB: LAB JOB to :LAB:RMX86 

DELETE : LAB : RMX86 ( I NT3TASKM0D ) 

ADD /DINT3/INT3JOB to :LAB:RMX86 

EXIT 


* THE STUDENT MAY "OPTIONALLY" USE A "GIVEN" SUBMIT FILE THAT WILL 
COMPILE , LINK , LOCATE AND ADD THE FINAL MODULE TO THE SYSTEM 

- SUBMIT :LAB:JOB.CSD 
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******* LAB SIX fAPP LOADER SYSTEM) ******* 


STEPS: 

BUILD THE NON RESIDENT JOB ' 

MODIFY A SOURCE FILE (PARTIALLY SUPPLIED FOR YOU) NAMED :LAB:FLASHJ0B.P86 
WITH THE "ALTER" TEXT EDITOR 

- ALTER :LAB:FLASHJ0B.P86 

* THIS SOURCE FILE IS THE NON RESIDENT TASK THAT CONFORMS TO THE FOLLOWING 
FLOWCHART 

DO FOREVER 

OUTPUT OFFH TO PORT 09CH 
GO TO SLEEP FOR 1/4 SEC 
OUTPUT 0 TO PORT 09CH 
GOT TO SLEEP FOR 1/4 SEC 


STEP7: 

COMPILE THE SOURCE FILES (FLASHJ0B.P86) 

- PLM86 :LAB:FLASHJ0B.P86 

* IF ANY ERRORS OCCURRED DURING COMPILATION , YOU MUST FIX AND 
RECOMPILE BEFORE CONTINUING 

* IF COMPILATION IS SUCCESFUL THE COMPILER WILL CREATE 

- A LIST FILE NAMED ": LAB: (SOURCE) .LST" 

- AN OBJECT FILE NAMED ": LAB: (SOURCE) .OBJ" 

LINK THE OBJECTS WITH THE INTERFACE LIBRARIES NEEDED (LARGE) 

LINK86 :LAB:FLASHJOB.OBJ, & 

/RMX5.0/DUTILS/RPIFL.LIB & 

TO : LAB: FLASH JOB & 

NOMAP SEGSIZE(STACK(512)) BIND 

COPY THE JOB INTO A FILE ON THE FLOPPY 

COPY :LAB:FLASHJOB OVER :FDO:FLASHJOB 
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******* LAB SIX (APR LOADER SYSTEM) ******* 


STEPS: 

* A LOCATE MAP AND SOURCE LISTING WILL HELP YOU DEBUG YOUR CODE IF 
PROBLEMS ARISE . THIS IS THE TIME TO GET THE LISTINGS OUT 

YOU ARE NOW READY TO "BOOT" YOUR NEWLY CREATED SYSTEM 

IF YOUR EXECUTION VEHICLE IS THE SAME AS THE DEVELOPMENT STATION 
THEN: 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 
-BOOT THE NEW SYSTEM 
.B /"TEAM NAME"/LAB6/RMX86 

IF YOUR EXECUTION VEHICLE DIFFERS FROM THE DEVELOPMENT STATION 
THEN: 

-COPY THE NEWLY CREATED BOOTABLE SYSTEM INTO A FLOPPY. 

( COPY :LAB:RMX86 OVER :FD0:RMX86 ) 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

-BOOT THE NEW SYSTEM 

.B /RMX86 

* THE 957 DEBUG MONITOR IS PRESENT AND CAN BE USED TO DEBUG 

YOUR CODE IF NESSESARY. PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

.* GOOD LUCK...! 
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CHAPTER 12 
iMMX 800 

Multi Message exchange Software 

• BASIC CONCEPTS 

• CHANNELS 

• mx SYSTEM CALLS 


• THE MMX JOB 



iMMX 800 
MESSAGE TRANSFER 

MESSAGE SENDING AND RECEIVING MODEL 


SENDING TASK 


RECEIVING TASK 


TASK ENTRY POINT 
INITIALIZE TASK 
— ^ PERFORM FUNCTION 
SEND MESSAGE--" 
WAIT FOR RESPONSE^I 



TASK ENTRY POINT 
INITIALIZE TASK 
WAIT FOR MESSAGE 
PERFORM FUNCTION 
SEND RESPONSE 



RMX SOFTWARE IMPLEMENTS THIS MODEL OF INTER TASK COMMUNICATION 
BETWEEN TASKS RESIDING ON THE SAME DEVICE (BOARD). 


iMMX SOFTWARE GENERALIZES THE MODEL TO ACCOMODATE INTERDEVICE 
COMMUNICATION. 
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BASIC CONCEPTS 




DEVICE - A PROCESSOR BOARD IN A SYSTEM 

PORT - A LOGICAL DELIVERY MECHANISM WHICH UTILIZED FIFO 
ORDER (QUEUE) 



12-2 
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’iMMX 800 

MESSAGE TRANSFER 



iM IMIKSMtC 


• HEADERS ARE NOT PASSED BETWEEN DEVICES 

• MEMORY SEGMENTS FOR MESSAGES ARE ALLOCATED BY 

- ‘iRMX 86 NUCLEUS 

- iRMX 80/88 FREE SPACE MANAGER (PMM) 
f TWO TRANSMISSION MODES ARE AVAILABLE 

- TRANSPARENT 

•MESSAGE RESIDES IN NON-S HARED MEMORY 
•MESSAGE IS COPIED PRIOR TO TRANSMISSION 
•COPIED ALSO AT RECEIPT 

- NON-TRANSPARENT 

•MESSAGE IS ACCESSIBLE BY BOTH DEVICES 
•COPY ONLY ON RECEIPT 


SUPPORTED SINGLE BOARD COMPUTERS 


Irmx 80 

OPERATING 

SYSTEM 

iRMX 88 
OPERATING 
SYSTEM 

iRMX 86 
OPERATING 
SYSTEM 

iSBC 80/24 

iSBC 86/05 

iSBC 86/05 

iSBC 80/30 

iSBC 86/12A 

iSBC 86/12A 

iSBC 544 

I SBC 86/14 

iSBC 86/14 

iSBC 569 

iSBC 86/30 

ISBC 86/30 


iSBC 88/25 

iSBC 88/25 


ISBC 88/40 

iSBC 88/40 


ISBC 88/45 

ISBC 88/45 







iMMX 800 


• COMES IN THREE VERSIONS 

- OPERATION UNDER iRMX 80 NUCLEUS 

•*iMMX 800/80 

- OPERATION UNDER iRMX 88 NUCLEUS 

*{MMX 800/880 FOR NON-MEfiABYTE SUPPORT 
•iMMX 800/881 FOR MEGABYTE SUPPORT 

-OPERATION UNDER \m 86 NUCLEUS 
*1mMX 800/86 

• ALL THREE VERSIONS PRESENT IDENTICAL USER INTERFACES 
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SOFTWARE MEMORY REQUIREMENTS 


EXECUTIVE 

K BYTES 

iRMX 

80 OPERATING SYSTEM 

3.7K BYTES 

iRMX 

88 OPERATING SYSTEM 
128K SUPPORT 
1MB SUPPORT 

N.8K BYTES 


"COMPACT" 

"LARGE" 

5.5K BYTES 
6.3K BYTES 

iRMX 

86 OPERATING SYSTEM 

6.6K BYTES 






APPLICATION EXAMPLE 

• WHEN AN OPERATOR ENTERS A REQUEST AT A TERMINAL. THE FOLLOWING 
SEQUENCE OCCURS: 

1. A TASK ON THE iSBC 80/2A BOARD IN THE TERMINAL BUILDS A MESSAGE 
THAT MEETS IRMX 80 MESSAGE-FORMAT REQUIREMENTS AND ISSUES A 
CQXFER CALL TO MMX 80. (CQXFER IS THE NAME OF THE iMMX 80 
TRANSFER PROCEDURE). 

2. MMX 80 TRANSFERS THE MESSAGE TO MMX 85 ON THE ISBC 86/12A BOARD. 

3. MMX 86 REFORMATS THE MESSAGE AND PASSES IT TO AN iRMX 86 TASK. 

4. THE I/O SYSTEM PERFORMS THE NECESSARY I/O OPERATIONS FOR THE TASK. 

5. THE TASK PUTS THE DATA IN A MESSAGE THAT SATISFIES RMX 86 FORMAT 
CONVENTIONS AND ISSUES A CQXFER CALL TO MMX 86. 

6. MMX 86 TRANSFERS THE MESSAGE TO MMX 80 ON THE iSBC 80/24 BOARD. 

7. MMX 80 REFORMATS THE MESSAGE TO MEET iRMX 80 FORMAT REQUIREMENTS 

AND PASSES IT TO THE iRMX 80 TASK. 

8. THE TASK EXTRACTS THE DATA FROM THE MESSAGE AND SENDS IT TO 

THE TERMINAL. ^ ^ 

^ 1 ^ — 

asnj © 0K 


iMMX SYSTEM CALLS 


FUNCTION 

NAME 

DESCRIPTION 

FIND PORT 

CQFIND 

FIND A PORT AND RETURN A CONNECTION-ID. 

ACTIVATE PORT 

CQACTV 

ACTIVATE A PORT FOR RECEIVING MESSAGES FROM 
OTHER TASKS. 

TRANSFER MESSAGE 

CQXFER 

TRANSFER A MESSAGE TO A PORT IDENTIFIED BY 
THE CONNECTION-ID. 

DEACTIVATE PORT 

CQDACT 

DEACTIVATE PORT. FURTHER MESSAGES ARE 
RETURNED TO THE SENDER. 

LOSE 

CQLOSE 

LOSES A CONNECTION TO A PORT. 
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WHAT IS MIP? 


• THE MULTIBUS INTERPROCESSOR PROTOCOL (MIP) IS A SPECIFICATION 
FOR A SET OF MECHANISMS AND PROTOCOLS. 

• PROVIDES AN EXCHANGE OF DATA AMONG TASKS EXECUTING ON VARIOUS 
SINGLE-BOARD COMPUTERS. 



MESSAGE MANAGER 


• FUNCTIONALITY FROM USER VIEWPOINT 


PRODUCER CONSUMER 















THREE-LEVEL INTERFACE STRUCTURE 


f THE VIRTUAL LEVEL. BY WHICH USER TASKS INTERACT WITH THE MIP FACILITY. 

t THE PHYSICAL LEVEL. BY WHICH THE MIP FACILITIES ON DIFFERENT DEVICES 
INTERACT WITH EACH OTHER. 

f THE LOGICAL LEVEL. WHICH TRANSLATES BETWEEN THE VIRTUAL LEVEL AND 
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^ ^ ^ 

SIGNALING 

• iriMX SOFTWARE SUPPORTS FOUR DIFFERENT SIGNALING f'lECHANISMS: 

- MULTIBUS INTERRUPTS 

- MEMORY MAPPED INTERRUPTS 

- lO-PORT MAPPED INTERRUPTS 

- POLLING 

A SOFTWARE HANDSHAKE THAT USES FLAGS IS ALSO EMPLOYED FOR 
MORE EFFICIENT THROUGH PUT. 

- E.G. A QUEUE KNOWN TO BE EMPTY IS NOT EXAMINED BY IM$BiK. 




f 
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STEPS IN BUILDING THE mx JOB 

1. BUILD A CONFIGURATION FILE NAMED R4CNFG.P86. 

2. COMPILE AND PRODUCE AN OBJECT MODULE. 

3. LINK THE MODULE TO A SET OF MMX LIBS. 

A. LOCATE THE LINKED MODULE TO AN ABSOLUTE ADDRESS. 
5. ENTER A "USER JOB" IN ICU86 FOR THE MMX JOB. 
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THE CONFIGURATION MODULE (RACNFG.P86) • 

• THE CONFIGURATION MODULE IS A SET OF STRUCTURES. 

• THESE STRUCTURES CONTAIN INFORMATION ABOUT THE CONFIGURATION 
AND REQUIREMENTS OF YOUR SYSTEM. 

• THESE STRUCTURES FALL INTO THREE CATEGORIES: 

- SYSTEM LEVEL DECISIONS 

- DEVICE LEVEL DECISIONS 

- PORT LEVEL DECISIONS 
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EXERCISE 


• THE CONFIGURATION CHAPTER IN THE mMXSOO REFERENCE 
MANUAL DESCRIBES EACH OF THE STRUCTURES IN DETAIL. 

• WITH THE AID OF YOUR INSTRUCTOR FILL IN THE BLANKS 
TO ACCOMODATE THE TWO RMX86 DEVICE EXAMPLE. 
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AN EXAMPLE CONFIGURATION FOR TWO RMX86 DEVICES 
• MEMORY MAP FOR OUR EXAMPLE: 

SBC 06A 


(DEVICE 0) 


10000H 


SHARED 

MEMORY 


FFFFH 


OH 


SBC 86/12A 


1 

L 


(DEVICE 1) 


SBC 86/12A 




MEM POOL 

\ FFFFH 

MEM POOL 

ROOT JOB 

\ 

ROOT JOB 

MMX JOB 

/PRIVATE 

MMX JOB 

APP JOB 

/ 

APP JOB 

NUCLEUS 

/ 

NUCLEUS 

VECTOR TABLE 

1 OH 

VECTOR TABLE 


►PRIVATE 


J 
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EXERCISE (CONTINUED) 

DECLARE CQDVCS BYTE PUBLIC 
DATA ( ); 

DECLARE CQSKTS BYTE PUBLIC 
DATA ( ); 

DECLARE CQPRTS BYTE PUBLIC 
DATA ( )j 

DECLARE CQMDLY WORD PUBLIC 
DATA ( ); 

DECLARE CQITWT WORD PUBLIC 
DATA ( ); 
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EXERCISE (CONTINUED) 


DECLARE DSDT ( ) DSD$ENTRY$TYPE 

PUBLIC 
DATA ( . 



DECLARE LPT$ROM ( 
PUBLIC 

DATA ( ); 

DECLARE. LPT$RAM ( 
PUBLIC; 


,) LPT$ROM$ENTRY$TYPE 


,) LPT$RAM$ENTRY$TYPE 
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EXERCISE (CONTINUED) 


DECLARE DCM$ROM (. 
PUBLIC 

DATA ( . 


) DM$ROM$ENTRY$TYPE 


); 

DECURE DCM$RAM (. 
PUBLIC; 


) DM$RAM$ENTRY$TYPE 


DECURE CQSGLY WORD PUBLIC 
DATA ( ); 


DECURE CQIDPD WORD PUBLIC 
DATA ( ); 
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EXERCISE (CONTINUED) 


DECLARE SF (. 
PUBLIC 
DATA ( 


) SF$ENTRY$TYPE 


00CEH. 

0003H 

00H, 

0000H. 

0000H, 

000H, 

0000H. 

0000H); 

DECLARE CQIDSS BYTE PUBLIC 
DATA ( ); 

DECLARE IDST ( ) IDS$ENTRY$TYPE 

PUBLIC 

DATA ( ); 



EXERCISE (CONTINUED) 


DECLARE CQPLHS BYTE PUBLIC 
DATA ( )j 


DECLARE PLHTBL ( 


) POOL$ENTRY$TYPE PUBLIC; 


DECLARE CQBLKS BYTE PUBLIC 
DATA ( ); 


DECLARE BLKTBL 
PUBLIC 
DATA ( 


BLOCK$ENTRY$TYPE 
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******* LAB SEVEN (MMX800/86 SYSTEM) PART A ******* 


3B0ECTIVES: 

EXECUTE A STUDENT MMX800/86 APPLICATION JOB IN AN RMX86 O.S. ENVIROMENT 

INTRODUCE IMMX800/86) SYSTEM CALLS: 

- CQSACTV 

- CQSFIND 

- CQSXFER 

CREATE SOURCE CODE: 

- A SOURCE FILE NAMED START. P86 

- A SOURCE FILE NAMED MMXLAB.P86 

COMPILE (PLM86), LINK, AND LOCATE AN APPLICATION JOB, THAT WILL CALL UPON 
THE MMX800/86 TO COMMUNICATE WITH AN EXTERNAL DEVICE 
ITHE TRUTH IS THAT WE WILL ONLY USE ONE DEVICE , AND THAT DEVICE WILL 
COMMUNICATE WITH ITSELF...) 


STEPl : 

USE THE ATTACHSFILE COMMAND TO ATTACH THE DIRECTORY NAMED (/"TEAM NAME"/LAB7) 
AS THE LOGICAL NAME (:LAB:) 

- AFILE /"TEAM NAME"/LAB7 AS :LAB: 

* FOR THE REST OF THIS LAB WE WILL USE THIS LOGICAL NAME * 



• USE MMX 800/86 SYSTEM CALLS 

• COMMUNICATION TO A LIGHT BOX 

• SIMULATE INTERDEVICE COMMUNICATION 
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******* LAB SEVEN (MMX800/86 SYSTEM) PART A ******* 

STEP2: 

MODIFY A SOURCE FILE (PARTIALLY SUPPLIED FOR YOU) NAMED :LAB :MMXLAB.P86 
WITH THE "ALTER" TEXT EDITOR 

- ALTER :LAB:MMXLAB.P86 

* THIS SOURCE FILE IS THE APPLICATION TASK THAT CONFORMS TO THE FOLLOWING 
FLOWCHART 

ACTIVATE THE PODUCER PORT 
FIND THE CONSUMER CONNECTION 
DO FOREVER 

CREATE A SEGMENT 

1ST BYTE IN SEGMENT = READ SWITCHES PORT 9CH 
2ND BYTE IN SEGMENT = READ SWITCHES PORT 9DH 
TRANSFER MESSAGE (SEGMENT) TO OTHER DEVICE 
WAIT AND RECEIVE MESSAGE (SEGMENT) FROM OTHER DEVICE 
LIGTHS PORT 9CH = 1ST BYTE IN MESSAGE RECEIVED 
LIGTHS PORT 9DH = 2ND BYTE IN MESSAGE RECEIVED 
* DELETE SELF ** 
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******* LAB SEVEN (MMX800/86 SYSTEM) PART A ******* 


STEP3: 

* ROOT JOBS ABSOLUTELY ADDRESS THE STARTING LOCATION OF THE STUDENT'S 
JOB CODE. THE ENTRY POINT MAY VARY IF INTERNAL PROCEDURES OR 
CHARACTER CONSTANTS ARE USED. 

FOR THIS REASON IT IS ADVISABLE TO CREATE AND LINK A START TASK TO 
THE REST OF THE APPLICATION CODE TO FIX THE ENTRY POINT'S OFFSET 
INTO THE CODE 

* THIS APPLICATION JOB WILL BE A FIRST LEVEL JOB, THIS REQUIRES 
THAT A TASK WITHIN THIS JOB MAKE A CALL TO RQ$END$INIT$TASK 
TO RESUME THE ROOT TASK 

*'IN ORDER TO DEBUG OUR CODE BEFORE IT "CRASHES" WE MAY WISH TO 
INVOKE THE 957 MONITOR AT THE START OF OUR JOB'S EXECUTION. 

THIS CAN EASILY BE ACCOMPLISHED BY PLACING A "CAUSE$INTERRUPT(3) " 
INSTRUCTION AT THE BEGINNING OF OUR CODE (IN OUR START TASK). 

* WE WILL USE THE SAME START TASK THAT WE USED IN LAB TWO 

-COPY /RII5.0/LAB2/START.P86 TO : LAB: START. P86 
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******* LAB SEVEN (MMX800/86 SYSTEM) PART A ******* 

STEP4: 

COMPILE THE SOURCE FILES rSTART.P86 AND MMXLAB.P86) 

- PLM86 : LAB: START. P86 

- PLM86 :LAB:MMXLAB.P86 

* IF ANY ERRORS OCCURRED DURING COMPILATION , YOU MUST FIX AND 
RECOMPILE BEFORE CONTINUING 

* IF COMPILATION IS SUCCESFUL THE COMPILER WILL CREATE FOR EACH OF 
THE SOURCE FILES: 

- A LIST FILE NAMED LAB: (SOURCE) .LST" 

- AN OBJECT FILE NAMED LAB: (SOURCE) .OBJ" 

LINK THE OBJECTS WITH THE INTERFACE LIBRARIES NEEDED (LARGE) 

LINK86 :LAB: /START. OBJ,?. 

:LAB:/MMXLAB.OBJ,?« 

/MMX86/R4LINF.LIB,& 

/RMX5.0/DUTILS/EPIFL.LIB,& 

/RMX5.0/DUTILS/IPIFL.LIB,& 

/RMX5.0/DUTILS/RPIFL.LIB & 

TO :LAB:/JOB.LNK & 

NOMAP 

LOCATE THE LINKED MODULE TO AN ABSOLUTE ADDRESS 
L0C86 :LAB:/JOB.LNK & 

TO :LAB:/LABJOB & 

SC(3) SEGSIZE(STACK(0)) & 

ORDER ( CLASSES ( CODE , DATA , STACK ) ) & 

ADDRESSES ( CLASSES ( CODE ( 1040H ) ) ) & 

NOINITCODE & 

OC( PURGE) 

AND FINALLY ADD THE LOCATED MODULE TO THE OTHER PRECONFIGURED 
PARTS OF OUR SYSTEM 

LIB86 

DELETE : LAB : RMX86 ( STARTMOD ) 

ADD :LAB:LABJOB to :LAB:RMX86 
EXIT 

* :LAB:RMX86 IS A "GIVEN" FILE THAT CONTAINS: 

- A PRECONFIGURED NUCLEUS 

- A PRECONFIGURED MMX800/86 

- A PRECONFIGURED ROOT JOB 
= A PRECONFIGURED SDB 

* THE STUDENT MAY "OPTIONALLY" USE A "GIVEN" SUBMIT FILE THAT WILL 
COMPILE , LINK , LOCATE AND ADD THE FINAL MODULE TO THE SYSTEM 

- SUBMIT :LAB:JOB.CSD 
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******* LAB SEVEN (MMX800/86 SYSTEM) PART A ******* 

>TEP5: 

* A LOCATE MAP AND SOURCE LISTING WILL HELP YOU DEBUG YOUR CODE IF 
PROBLEMS ARISE . THIS IS THE TIME TO GET THE LISTINGS OUT 

YOU ARE NOW READY TO "BOOT" YOUR NEWLY CREATED SYSTEM 

IF YOUR EXECUTION VEHICLE IS THE SAME AS THE DEVELOPMENT STATION 
THEN: 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 
-BOOT THE NEW SYSTEM 
.B /"TEAM NAME"/LAB7/RMX86 

IF YOUR EXECUTION VEHICLE DIFFERS FROM THE DEVELOPMENT STATION 
THEN: 

-COPY THE NEWLY CREATED BOOTABLE SYSTEM INTO A FLOPPY. 

( COPY :LAB:RMX86 OVER :FD0:RMX86 ) 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

-BOOT THE NEW SYSTEM 

.B /RMX86 

* THE 957 DEBUG MONITOR IS PRESENT AND CAN BE USED TO DEBUG 

YOUR CODE IF NESSESARY. PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 
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******* LAB SEVEN (MMX800/86 SYSTEM) PART B ******* 

OBJECTIVES; 

EXECUTE A STUDENT MMX800/86 APPLICATION JOB IN AN RMX86 O.S. ENVIROMENT 

LEARN HOW TO BUILD A CONFIGURATION FILE , AND AN MMX86 JOB TO REPLACE THE 
ONE GIVEN IN THE PREVIOS LAB (LAB SEVEN PART A) 

CREATE SOURCE CODE: 

- A SOURCE FILE NAMED R4CNFG.P86 


STEPl: 

USE THE ATTACHSFILE COMMAND TO ATTACH THE DIRECTORY NAMED (/"TEAM NAME"/LAB7) 
AS THE LOGICAL NAME (:LAB;) 

- AFILE /"TEAM NAME"/LAB7 AS :LAB: 

* FOR THE REST OF THIS LAB WE WILL USE THIS LOGICAL NAME * 


STEP2: 

MODIFY A SOURCE FILE rPARTIALLY SUPPLIED FOR YOU) NAMED :LAB :R4CNFG.P86 
WITH THE "ALTER" TEXT EDITOR 

- ALTER :LAB;R4CNFG.P86 

* THIS SOURCE FILE IS THE MMX86 CONFIGURATION FILE 
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★★★**★* 


LAB SEVEN (MMX800/86 SYSTEM) PART B ******* 


5TEP3: 

COMPILE THE SOURCE FILE (R4CNFG.P86) 

- PLM86 :LAB:R4CNFG.P86 

* IF ANY ERRORS OCCURRED DURING COMPILATION , YOU MUST FIX AND 
RECOMPILE BEFORE CONTINUING 

* ELSE THE FOLLOWING FILES WILL BE CREATED 

- A LIST FILE NAMED ":LAB: (SOURCE) .LST" 

- AN OBJECT FILE NAMED ":LAB: (SOURCE) .OBJ" 

LINK THE OBJECTS WITH THE INTERFACE LIBRARIES NEEDED (LARGE) 

LINK86 /MMX86/R4DRVR.LIB(MBEGIN) ,& 

:LAB:R4CNFG,0BJ,& 

/MMX86/R4DRVR.LIB ,& 

/MMX86/R4XMGR.LIB ,& 

/MMX86/R4957P.LIB ,& 

/MMX86/R4PMM.LIB ,& 

/MMX86/R4UTIL.LIB 
/RMX5.0/DUTILS/RPIFC.LIB & 

TO :LAB:JOB.LNK & 

NOMAP NOTYPE 

LOCATE THE LINKED MODULE TO AN ABSOLUTE ADDRESS 
L0C86 :LAB:JOB.LNK & 

TO :LAB:MMXJOB & 

SCO) SEGSIZE(STACK(0)) & 

ORDER ( CLASSES ( CODE , DATA , STACK ) ) & 

ADDRESSES ( CLASSES ( CODE ( 3000H )’ ) ) & 

NOINITCODE & 

OC(PURGE) 

AND FINALLY ADD THE LOCATED MODULE TO THE OTHER ’PRECONFIGURED 

PARTS OF OUR SYSTEM 


.IB86 

DELETE :LAB:RMX86(MBEGIN) . 

\DD :LAB:MMXJOB to :LAB:RMX86 

:xiT 


* THE STUDENT MAY "OPTIONALLY" USE A "GIVEN" SUBMIT FILE THAT WILL 
COMPILE , LINK , LOCATE AND ADD THE FINAL MODULE TO THE SYSTEM 

- SUBMIT :LAB:MMXJOB.CSD 
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******* LAB SEVEN fMMX800/86 SYSTEM) PART B ******* 

STEPS: 

* A LOCATE MAP AND SOURCE LISTING WILL HELP YOU DEBUG YOUR CODE IF 
PROBLEMS ARISE . THIS IS THE TIME TO GET THE LISTINGS OUT 

YOU ARE NOW READY TO "BOOT" YOUR NEWLY CREATED SYSTEM 

IF YOUR EXECUTION VEHICLE IS THE SAME AS THE DEVELOPMENT STATION 
THEN: 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 
-BOOT THE NEW SYSTEM 
.B /"TEAM NAME"/LAB7/RMX86 

IF YOUR EXECUTION VEHICLE DIFFERS FROM THE DEVELOPMENT STATION 
THEN: 

-COPY THE NEWLY CREATED BOOTABLE SYSTEM INTO A FLOPPY. 

( COPY :LAB:RMX86 OVER :FD0:RMX86 ) 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

-BOOT THE NEW SYSTEM 

.B /RMX86 

* THE 957 DEBUG MONITOR IS PRESENT AND CAN BE USED TO DEBUG 

YOUR CODE IF NESSESARY. PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 
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CHAPTER 13 
HUMAN INTERFACE 

t COMMANDS 

• SYSTEM CALLS 

• THE RESIDENT USER 


j 


• DEFINITION FILES 



HUMAN INTERFACE COMMANDS^ 


7 


• COMMANDS ARE PROGRAMS (COPY. RENAME ETC.) 

• THESE PROGRAMS ARE JOBS CREATED BY THE H. I. 

0 LOADED BY THE HUMAN INTERFACE UPON OPERATOR'S REQUEST. 



RMX BOX 

PERIPHERAL 1 
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INTEL PROVIDES A SET OF COMMANDS 


ATTACHDEVICE 

DIR 

JOB DELETE 

ATTACHFILE 

DISKVERIFY 

LOCK 

BACKUP 

DOWNCOPY 

PERMIT 

COPY 

FORMAT 

RENAME 

CREATED I R 

INITSTATUS 

RESTORE 

DATE 


SUBMIT 

DEBUG 


SUPER 

DELETE 


TIME 

DETACHDEVICE 


UPCOPY 

DETACHFILE 


VERSION 


0 A COMPLETE DESCRIPTION OF THESE COMMANDS ARE FOUND IN THE 
iRMX 86 OPERATOR'S MANUAL. 






SYSTEM CALLS 


• A SET OF CALLS ARE AVAILABLE TO AID IN THE CREATION OF CUSTOM 
COMMANDS. 


C$GET$INPUT$CONNECTION 

C$GET$OUTPUT$CONNECTION 

C$GET$CHAR 

C$GET$INPUT$PATHNAME 

C$GET$PARAMETER 

C$GET$OUTPUT$PATHNAME 

C$SET$PARSE$BUFFER 


C$GET$COMMAND$NAME 

C$FORMAT$EXCEPTION 

C$SEND$CO$RESPONSE 

C$SEND$EO$RESPONSE' 

C$CREATE$COMMAND$CONNECTION 

C$DELETE$COMMAND$CONNECTION 

C$SEND$COMMAND 


• A COMPLETE DESCRIPTION OF THESE H.I. SYSTEM CALLS ARE FOUND IN 
THE 1RMX86 HUMAN INTERFACE REFERENCE MANUAL. 
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THE RESIDENT USER 


t THE RESIDENT USER MAY BE: 

-THE ONLY USER IN THE SYSTEM 

-THE FIRST USER IN A MULT I -ACCESS SYSTEM 

• RESIDENT USER IS DEFINED DURING CONFIGURATION BY: 

-TERMINAL DEVICE NAME 
-MAX TASK PRIORITY 
-USER ID 

-INITIAL PROGRAM 
-DEFAULT PREFIX 
-POOL SIZE 
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MULTI -ACCESS USER DEFINITION 

• OTHER USERS ARE DEFINDED IN FILES THAT DESCRIBE THE 
OPERATOR AND HIS TERMINAL . 

• THE PATHNAMES FOR THESE FILES ARE: 

CONFIG/TERMINALS (TERMINAL DEFINITION FILE) 


CONFIG/USER/ID# 


(USER DEFINITION FILE) 


• ID# IS THE ACTUAL ID NUMBER FOR THAT PARTICULAR USER 

-E.G. CONFIG/USER/(2082 

• IF THESE FILES DO NOT EXIST. THE HUMAN INTERFACE WILL 
COME UP IN SINGLE-ACCESS MODE. 
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TERMINAL DEFINITION FILE 


• # OF TERMINALS 

• DEVICE - NAME 

• USER - ID 

• PARTITION - SIZE 
f MAX - PRIORITY 

• UNIT - PATHNAME 


:SD: CONFIG/TERMINALS 
EXAMPLE OF FOUR TERMINALS 
4 

Tl. 42.90 <CR> 

T0.65535.8O.21O.:SD:SPECLI <CR> 
T3. 85. 64.220 <CR> 

T2. 85.64.225 <CR> 



USER DEFINITION FILE 


USER- ID 
PASSWORD 

DEFAULT-PARTITION 
MAX-PARTITION 
MAX-PRIORITY 
DEFAULT-PREFIX 
I NIT-PATHNAME 


:SD: CONFIG/USER/65535 
EXAMPLE OF ONE USER 

65535. PASS. 64<CR> 
120<CR> 

190 <CR> 

:SD: USER/65535 <CR> 


A COMPLETE DESCRIPTION OF THESE FILES IS FOUND IN THE IRMX 86 
CONFIGURATION GUIDE. 
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*★*★**★ lab eight (H.I. CONFIG THROUGH ICU) ******* 


DBJECTIVES: 

THE STUDENT WILL USE THE INTERACTIVE CONFIGURATION UTILITY (ICU) 

TO CREATE A SINGLE ACCESS SYSTEM 

THIS SYSTEM WILL CONTAIN 
. - A NUCLEUS JOB 

- A BIOS JOB 

- A EIOS JOB 

- A LOADER JOB 

- A HUMAN INTERFACE JOB 

STEP!.: 

USE THE ATTACHSFILE COMMAND TO ATTACH THE DIRECTORY NAMED f/"TEAM NAME"/LAB8) 
AS THE LOGICAL NAME f:LAB:) 

- AFILE /"TEAM NAME"/LAB8 AS :LAB: 

* FOR THE REST OF THIS LAB WE WILL USE THIS LOGICAL NAME * 
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******* LAB EIGHT (H.I. CONFIG THROUGH ICU) ******* 


STEP2: 


THE fICU) IS INVOKED BY TYPING THE FOLLOWING 
-ICU86 :LAB:ICU.DEF 

* WHERE ICU.DEF IS THE NAME OF THE FILE WE HAVE CHOSEN TO CONTAIN . 
THE INFORMATION NEEDED TO CONFIGURE OUR O.S. 

WHEN THE ICU SIGN ON ENTER THE COMMAND C , TO MODIFY THE SCREENS 


STEPS: 

* TRY FILLING THE SCREENS WITHOUT LOOKING AT THESE FIRST, 

THEN MATCH YOUR ENTRIES TO THE ONES GIVEN HERE 

* IF YOU DO NOT UNDERSTAND AN ENTRY TYPE ? 

- E.G. OSP?<cr> 

* SOME OF THE SCREENS NEEDED FOR OUR LAB EIGHT CONFIGURATION FOLLOW 

Type : RAM = 0104H, 24FFH 
Type : RAM = 26B6H, F7FFH 

Human Interface 

(ICL) Initial Command Line Size fO-OFFFFH) OlOOH 

(CNM) Command Name Length ^0-255) - 0030H 

fSYSl System Directory (1-45 characters) 

:SD: SYSTEM 

(DRP) Default Resident Initial Program (Yes/No) Yes 
(RIP) Resident Initial Program (1-45 characters) 


Default 

(CDN) Configuration Device Name (1-14 chars) :SD: 
(PMI) Human Interface Pool Minimum (O-OFFFFH) 0260H 

(PMA) Human Interface Pool Maximum (O-OFFFFH) FFFFH 

(HIR) Human Interface in ROM (Yes/No) No 

HI Jobs 

(MIN) Jobs Minimum Memory (O-OFFFFH pages) 0200H 

(MAX) Jobs Maximum Memory (O-OFFFFH pages) OOOOH 

(NPX) Numeric Processor Extension Used (Yes/No) Yes 

Resident User 

(TDN) Terminal Device Name (1-12 Characters) TO 
(MTP) Maximum Task Priority (O-OFFH) OOAOH 

(UID) User ID Number (O-OFFFFH) OOOOH 

(MIN) Minimum Memory Required (O-OFFFFH) lOOOH 

(MAX) Maximum Memory Required (O-OFFFFH) FFFFH 


(IPP) Initial-Program Pathname (RESIDENT/1-45 Characters) 

RESIDENT 

(DEF) Default Directory (1-45 characters) 

:SD:USER 
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******* LAB EIGHT fH.I. CONFIG THROUGH ICU) ******* 


Prefixes 

Prefix : 1-45 characters 
Prefix : :$: 

Prefix : :PROG: 

Prefix : rSYSTEM: 

Prefix : :LANG: 

Prefix : 

HI Logical Names 

Logical Name : logical_name,path_name 
(1-12 Chars ,1-45 Chars) 

Logical Name : WORK, :SD:USER/WORK 

Logical Name : LANG, :SD:LANG 

Logical Name : PROG, :SD:USER/PROG 


EIOS 

(ASC) All Sys Calls in EIOS ‘ Req 

(ABR) Automatic Boot Device Recognition f Yes/No) Yes 

(DLN) Default System Device Logical Name fl-12 characters) SD 
(DPN) Default System Device Physical Name (1-12 characters) IWO 

(dFD) Default System Device File Driver f Phys/Str/Named) Named 

(DO) Default System Device Owners ID (O-OFFFFH) OOOOH 

(EBS) Internal Buffer Size (O-OFFFFh) 0400H 

(DDS) Default 10 Job Directory Size (5-OFFOh) 0020H 

(ITP) Internal EIOS Task's Priorities fO-OFFH) 0083H 

(PMI) EIOS Pool Minimum (O-OFFFFH) ^ 0180H 

(PMA) EIOS Pool Maximum f O-OFFFFH) ’ 0180H 

(EIR) Extended I/O System in ROM fYes/No) No 


Logical Names 

Logical Name : logical_name,device_name,f i le_driver,owners-id 

(1-12 Chars ,1-14 Chars ,Physical/Stream/Named, O-OFFFFH) 
Logical Name : BB, BB, Physical, OOOOH 
Logical Name : STREAM, STREAM, Stream, OOOOH 
Logical Name : FDO, WFDDO, Named, FFFFH 


Intel Terminal Driver 

(IIL) Input Interrupt Level (Encoded) 0068H 

(oil) Output Interrupt Level (Encoded) 0078H 

(UDP) USART Data Port (O-OFFFFH) 00D8H 

(USPj USART Status Port (O-OFFFFH) OODAH 

flRP) 8253 Input Rate Port (O-OFFFFH) 00D4H 

(ICP) 8253 Input Control Port (O-OFFFFH) 00D6H 

(IRC) 8253 Input Counter Number ^0-2) 0002H 

(IRM) Input Rate Maximum (O-OFFFFFFFFH) 00012C00H 

(ORP) 8253 Output Rate Port (O-OFFFFH) OOOOH 

(OCP) 8253 Output Control Port (O-OFFFFH) OOOOH 

(ORC) 8253 Output Counter Number (0-2) OOOOH 

(ORM) Output Rate Maximum (O-OFFFFFFFFH) OOOOOOOOH 

Intel iSBC 215/218 Driver 

(IL) Interrupt Level (Encoded Level) 0058H 

(ITP) Interrupt Task Prior itv (O-OFFH) 0082H 

(WIP) Wakeup I/O Port (O-OFFFFH) OlOOH 
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******* LAB EIGHT fH.I. CONFIG THROUGH ICU) 


Intel iSBC 215/218 Unit Information 

(NAM) Unit Info Name (1-17 Chars) uinfo__215gen 

(MR) Maximum Retries (O-OFFFFH) 0009H 

(CS) Cylinder Size (O-OFFFFH) OOOOH 

(NC) Number of Cylinders (O-OFFFFH) OOOIH 

(NFH) Number of Fixed Platters/Disk (O-OFFH) OOOIH 

(NRH) Number of Remove Platters/Disk (O-OFFH) OOOOH 

(NSl Number of Sectors/Track fO-OFFFFH) OOOCH 

(NAC) Number of Aux. Cylinders f O-OFFH 1 OOOIH 

(SSN Starting Sector Number (O-OFFFFFFFFHl OOOOOOOOH 

(BTl) Bad Track Information (Yes/No) Yes 


Intel iSBC 215/218 Unit Information 

(NAMl Unit Info Name n.-17 Charsl uinfo__215w 

(MR) Maximum Retries ( O-OFFFFH 1 0009H 

CS) Cylinder Size (O-OFFFFHl OOOOH 

(nC) Number of Cylinders (O-OFFFFH) 0208H 

(NFH) Number of Fixed Platters/Disk ^O-OFFH) 0005H 

(NRH) Number of Remove Platters/Disk f O-OFFH) OOOOH 

(NS) Number of Sectors/Track f O-OFFFFH) OOOCH 

(NAC) Number of Aux. Cylinders (O-OFFH) OOOAH 

(SSN) Starting Sector Number ^O-OFFFFFFFFH) OOOOOOOOH 
(BTI) Bad Track Information ^ Yes/No) Yes 

Intel iSBC 2i5/218 Unit Information 

(NAM) Unit Info Name (1-17 Chars) uinfo__215pt 

(MR) Maximum Retries (O-OFFFFH) 0009H 

(CS) Cylinder Size (O-OFFFFH) ' OOOOH 

(NC) Number of Cylinders (O-OFFFFH) 01D2H 

(NFH) Number of Fixed Platters/Disk (O-OFFH) 0003H 

(NRH) Number of Remove Platters/Disk (O-OFFH) OOOOH 

(NS) Number of Sectors/Track (O-OFFFFH) OOOCH 

(NAC) Number of Aux. Cylinders (O-OFFH) 0006H 

SSN) Starting Sector Number (O-OFFFFFFFFH) OOOOOOOOH 
(BTI) Bad Track Information ^Yes/No) Yes 


Intel iSBC 215/218 Unit Information 

(NAM) Unit Info Name (1-17 Chars) uinfo_215f 

(MR) Maximum Retries (O-OFFFFH) 0009H 

fCS) Cylinder Size (O-OFFFFH) OOOOH 

(NC) Number of Cylinders (O-OFFFFH) 004DH 

(NFH) Number of Fixed Platters/Disk ^O-OFFH) OOOOH 

(NRH) Number of Remove Platters/Disk (O-OFFH) OOOIH 

fNS) Number of Sectors/Track (O-OFFFFH) OOIAH 

(NAC) Number of Aux. Cylinders (O-OFFH) OOOOH 

(SSN) Starting Sector Number (O-OFFFFFFFFH) OOOOOOOOH 

(BTl) Bad Track Information (Yes/No) Yes 
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******* LAB EIGHT (H. I. CONFIG THROUGH ICU) ******* 


Intel iSBC 215/218 Unit Information 

(NAM) Unit Info Name (1-17 Chars) uinfo_215fd 

(MR) .Maximum Retries (O-OFFFFH) 0009H 

(CS) Cylinder Size (O-OFFFFH) OOOOH 

(NC) Number of Cylinders (O-OFFFFH) 004DH 

(NFH) Number of Fixed Platters/Disk (O-OFFH) OOOOH 

(NRH) Number of Remove Platters/Disk ^O-OFFH) 0002H 

(NS) Number of Sectors/Track (O-OFFFFH) OOIAH 

(NAC) Number of Aux. Cylinders (O-OFFH) OOOOH 

(SSN) Starting Sector Number (O-OFFFFFFFFH) OOOOOOOOH 
(BTl) Bad Track Information (Yes/No) Yes 


Intel iSBC 215/iSBX 218 Device-Unit Information 
(NAM) Device-Unit Name ^1-13 chars) 

(PFD) Physical File Driver Required ^Yes/No) 

(NFD) Named File Driver Required (Yes/No) 

(SDD) Single or Double Density Disks (Single/Double) 
(SDS) Single or Double Sided Disks (Single/Double) 

(EFI) 8 or 5 Inch Disks (8/51 
(GRA) Granularity rO-OFFFFHl' 

(DSZ) Device Size (O-OFFFFFFFFH) 

(UN) Unit Number on this Device (O-OFFH) 

(UIN) Unit Info Name (1-17 Chars) 

(UDT) Update Timeout (O-OFFFFH) 

NB) Number of Buffers (nonrandom = 0/rand = 1-OFFFFH) 

FUP) Fixed Update (True/False) 

(MB) Max Buffers rO-OFFH) 


Intel iSBC 215/iSBX 218 Device-Unit Information 
(NAM) Device-Unit Name (1-13 chars) IWO 

(PFD) Physical File Driver Required (Yes/No) Yes 

(NFD) Named File Driver Required (Yes/No) Yes 

(SDD) Single or Double Density Disks ^Single/Double) Single 

(SDS) Single or Double Sided Disks (Single/Double) Single 

(EFI) 8 or 5 Inch Disks (8/5) 8 

(GRA) Granularity (O-OFFFFH) 0400H 

(DSZ) Device Size (O-OFFFFFFFFH) 01DE2000H 

(UN) Unit Number on this Device (O-OFFH) OOOOH 

(UIN) Unit Info Name (1-17 Chars) uinfo_215w 

(UDT) Update Timeout (O-OFFFFH) 0064H 

(NB) Number of Buffers (nonrandom = 0/rand = 1-OFFFFH) 0006H 

(FUP) Fixed Update (True/False) True 

(MB) Max Buffers (O-OFFH) OOFFH 


WO 
Yes 
Yes . 

Single 

Single 

8 

0400H 

00000400H 

OOOOH 

uinfo_215gen 

0064H 

0006H 

True 

OOFFH 
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******* LAB EIGHT (H.I. CONFIG THROUGH 

Intel iSBC 215/iSBX 218 Device-Unit Information 
(NAM) Device-Unit Name (1-13 chars) 

(PFD) Physical File Driver Required (Yes/No) 

(NFD) Named File Driver Required (Yes/No) 

(SDD) Single or Double Density Disks (Single/Double) 
(SDS) Single or Double Sided Disks (Sinqle/Double) 

(EFI) 8 or 5 Inch Disks (8/5) 

(GRA) Granularity (O-OFFFFH) 

(DSZ) Device Size (O-OFFFFFFFFHl 

(UN) Unit Number on this Device (O-OFFH) 

(UIN) Unit Info Name (1-17 Chars) 

(UDT) Update Timeout (O-OFFFFH) 

(NB) Number of Buffers (nonrandom = O/rand = 1-OFFFFH) 
(FUP) Fixed Update (True/Falsel 
(MB) Max Buffers (O-OFFH) 

Intel iSBC 215/iSBX 218 Device-Unit Information 
(NAM) Device-Unit Name (1-13 chars) 

(PFD) Physical File Driver Required ^Yes/No) 

(NFD) Named File Driver Required (Yes/No) 

(SDD) Single or Double Density Disks ^Single/Double) 
(SDS) Single or Double Sided Disks (Single/Double) 

(EFI) 8 or 5 Inch Disks (8/5) 

(GRA) Granularity (O-OFFFFH) 

(DSZ) Device Size (O-OFFFFFFFFH) 

(UN) Unit Number on this Device ^OrOFFH) 

(UIN) Unit Info Name (1-17 Chars) 

(UDT) Update Timeout (O-OFFFFH) 

(NB) Number of Buffers (nonrandom = O/rand = 1-OFFFFH) 
(FUP) Fixed Update (True/False) 

(MB) Max Buffers (O-OFFH) 

Intel iSBC 215/iSBX 218 Device-Unit Information 
(NAM) Device-Unit Name (1-13 chars) 

(PFD) Physical File Driver Required (Yes/No) 

(NFD) Named File Driver Required (Yes/No) 

(SDD) Single or Double Density Disks (Single/Double) 
(SDS) Single or Double Sided Disks (Single/Double) 

(EFI) 8 or 5 Inch Disks (8/5) 

(GRA) Granularity (O-OFFFFH) 

(DSZ) Device Size (O-OFFFFFFFFH) 

(UN) Unit Number on this Device (O-OFFH) 

(UIN) Unit Info Name (1-17 Chars) 

(UDT) Update Timeout (O-OFFFFH) 

(NB) Number of Buffers (nonrandom = O/rand = 1-OFFFFH) 
(FUP) Fixed Update (True/False) 

(MB) Max Buffers (O-OFFH) 


ICU) ******* 


PWO 

Yes 

Yes 

Single 

Single 

8 

0400H 

0102C000H 

OOOOH 

uinfo_215pt 

0064H 

0006H 

True 

OOFFH 


WFO 

Yes 

Yes 

Single 

Single 

8 

0080H 

0003E900H 

0008H 

uinfo_215f 

0064H 

0006H 

True 

OOFFH 


WFDO 

Yes 

Yes 

Double 

Single 

8 

OlOOH 

0007C500H 

0008H 

uinfo 215f 

0064H“ 

0006H 

True 

OOFFH 
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******* LAB EIGHT (H.I. CONFIG THROUGH ICU) 

Intel iSBC 215/iSBX 218 Device-Unit Information 
’NAM) Device-Unit Name (1-13 chars) 

’PFD) Physical File Driver .Required (Yes/No) 

’NFD) Named File Driver Required f Yes/No) 

’SDD) Single or Double Density Disks (Single/Doublel 
SDS) Single or Double Sided Disks (Single/Double) 

’EFi) 8 or 5 Inch Disks (8/5) 

’GRA) Granularity (O-OFFFFHl 
:dSZ) Device Size (O-OFFFFFFFFHl 
'UN) Unit Number on this Device (O-OFFH) 

[UIN) Unit Info Name (1-17 Chars) 

;UDT) Update Timeout (O-OFFFFH) 

'NB) Number of Buffers (nonrandom = 0/rand = 1-OFFFFH) 

'FUP) Fixed Update (True/False) 

'MB) Max Buffers (O-OFFH) 

***** jHis JOB SUPPLIES THE INTERRUPT FOR THE MONITOR **** 


Jser Jobs 

;0DS) Object Directory Size (O-OFFOH) OOOAH 

:PMn Pool Minimum (20H - OFFFFH) 0030H 

'PMA) Pool Maximum (20H - OFFFFH) FFFFH 

'MOB Maximum Objects (1 - OFFFFH) FFFFH 

MTK) Maximum Tasks (1 - OFFFFH) FFFFH 

'MPR) Maximum Priority (0 - OFFH) OOOOH 

[AEH) Address of Exception Handler (CS:IP) OOOOHiOOOOH 

[EM) Exception Mode (Never/Prog/Enyiron/Al 1) Never 
'PVj Parameter Validation (Yes/No) Yes 

;TP) Task Priority (O-OFFHl OOOOH 

'TSA) Task Start Address (CS:IP) 0080H:0002H 

[DSB) Data Seqment Base (O-OFFFFHl OOOOH 

;SSA) Stack Segment Address (SS:SP1 OOOOHiOOOOH 

;SS1 Stack Size (O-OFFFFH) 0200H 


[NPX) Numeric Processor Extension Used (Yes/No) No 

[ncludes and Libraries 
^ath Name (1-45 Characters! 

[UDF) UDI includes and Libs 

/RMX5.0/DUDI/ 

[HIF) Human Interface Includes and Libs 

/RMX5.0/DINCLSLIBS/ 

(EIF) Extended I/O System Includes and Libs 

/RMX5.0/DINCLSLIBS/ 

(ALF) Application Loader Includes and Libs 

/RMX5.0/DL0ADER/ 

(BIF) Basic I/O System Includes and Libs 

/RMX5.0/DINCLSLIBS/ 

(THF) Terminal Handler and Debugger Includes and Libs 

/RMX5.0/DDEBTH/ 

(NUF) Nucleus and Root Job Includes and Libs 

/RMX5.0/DNUCLUS/ 

(ILF) Interface Libraries 

/RMX5.0/DUTILS/ 

(CAF) Crash Analyzer Includes and Libs 

/RMX5.0/DUDI/ 

(DTF) Development Tools Path Names 

. :;r /LANG/ 


WFDDO 

Yes 

Yes 

Double 

Double 

8 

OlOOH 

000F9700H 

0008H 

uinfo__215fd 

0064H 

0006H 

True 

OOFFH 
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******* LAB EIGHT (H.I. CONFIG THROUGH ICU) ******* 


STEP4: 

AFTER YOU ENTER ALL OF THE SCREENS ENTER G TO GENERATE 
EXIT THE ICU 

SUBMIT THE ICU.CSD FILE TO GENERATE YOUR SYSTEM 
-SUBMIT :LAB: ICU.CSD 


STEPS: 

YOU MUST NOW ADD THE SDB TO THE SYSTEM, 

USING THE LIB86 UTILITY 

-LIB86 

DELETE :LAB:RMX86(INT3TASKMOD) 

ADD /DINT3/INT3JOB to :LAB:RMX86 
EXIT 

STEPS: 

YOU ARE NOW READY TO "BOOT” YOUR NEWLY CREATED SYSTEM 

IF YOUR EXECUTION VEHICLE IS THE SAME AS THE DEVELOPMENT STATION 
THEN: 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 
-BOOT THE NEW SYSTEM 
.B /"TEAM NAME"/LAB8/RMX86 

IF YOUR EXECUTION VEHICLE DIFFERS FROM THE DEVELOPMENT STATION 
THEN: 


-COPY THE NEWLY CREATED BOOTABLE SYSTEM INTO A FLOPPY. 
( COPY :LAB:RMX86 OVER :FD0:RMX86 ) 

-PRESS INTERRUPT ON EXECUTION VEHICLE FRONT PANEL 

-BOOT THE NEW SYSTEM 

.B /RMX86 
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CHAPTER 14 

UNIVERSAL DEVELOPMENT INTERFACE 

§ SPECIFICATIONS 
• LIBRARIES 
t DEVELOPMENT PROCESS 


• SYSTEM CALLS 



WHAT /WHY UDI? 


UNIVERSAL DEVELOPMENT INTERFACE 


UDI IS A SPECIFICATION OF A SET OF PROCEDURE CALLS THAT ARE 
USED TO REQUEST OPERATING SYSTEM FUNCTIONS. 

FUNCTIONS ARE IMPLEMENTED BY MODULES THAT TRANSLATE FROM THE 
UDI STANDARD TO THE ACTUAL OPERATING SYSTEM CALLS. 

EACH INTEL OPERATING SYSTEM FOR THE lAPX 86.88 FAMILY PROVIDES 
A UNIVERSAL DEVELOPMENT INTERFACE OR A SUBSET THEREOF. 
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UDI FUNCTIONS 

THE KINDS OF FUNCTIONS THAT ARE AVAILABLE THROUGH UDI PROCEDURE 
CALLS INCLUDE; 

• CREATING AND BREAKING CONNECTIONS TO DATA FILES 

• OPENING. READING. SEEKING. WRITING. AND CLOSING DATA FILES 

• CONTROLLING PROGRAM EXECUTION 

• CONTROLLING MEMORY ALLOCATIONS 

• HANDLING SYSTEM EXCEPTION CONDITIONS 

• CONTROLLING THE PROCESSING OF CONSOLE INPUT & PARSING 
COMMAND LINES 

f FETCHING THE CURRENT DATE AND TIME 
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• YOU CAN MAKE OPERATING SYSTEM CALLS DIRECTLY FROM YOUR 
APPLICATION (SUBJECT TO SYSTEM AND LANGUAGE RESTRICTIONS). 


• IF YOU DO SO^ HOWEVER. YOU MAY NOT BE ABLE TO TRANSPORT 
YOUR APPLICATION TO ANOTHER OPERATING ENVIRONMENT. 


• ADHERING TO UDI SPECIFICATIONS ENSURES THAT YOUR APPLICATION 
REMAINS OPERATING-SYSTEM INDEPENDENT AND TRANSPORTABLE. 


THE IRMX OPERATING SYSTEM CONSISTS OF A NUMBER OF SUBSYSTEMS 


RMX LAYERS i 

DESCRIPTION 

NUCLEUS 

THE CORE OF THE iRMX 86 OPERATING SYSTEM 
AND IS REQUIRED FOR EVERY APPLICATION 
SYSTEM 

TERMINAL HANDLER 

PROVIDES A REAL-TIME INTERFACE BETWEEN 
YOUR TERMINAL AND OTHER SOFTWARE. 

BASIC I/O SYSTEM 

PROVIDES ASYNCHRONOUS FILE ACCESS 
CAPABILITIES 

EXTENDED I/O SYSTEM 

PROVIDES HIGH LEVEL. SYNCHRONOUS FILE 
ACCESS CAPABILITIES 

APPLICATION 

LOADER 

PROVIDES THE CAPABILITY TO LOAD OBJECT 
FILES INTO MEMORY FROM DISK 

HUMAN INTERFACE 

PROVIDES AN INTERACTIVE INTERFACE BETWEEN 
A USER AND SOFTWARE 
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. 

A 

1 UDI CALLS AND iRMX 86 SYSTEM CALLS 


UDI CALLS 

iRMX 86 SYSTEM CALLS 

SUBSYSTEMS 

DQSALLOCATE 

RQ$CREATE$SEGMENT 

NUCLEUS 

DQSAHACH 

RQ$S$ATTACH$FILE 

EXTENDED I/O SYSTEM 

DQ$CHANGE$EXTENSION 

(NONE) 

(NONE) 

DQSCLOSE 

RQ$S$CLOSE 

EXTENDED I/O SYSTEM 

DQSCREATE 

RQ$S$CREATE$FILE 

EXTENDED I/O SYSTEM 


RQ$S$GET$FILE$STATUS 


DQ$DECODE$EXCEPTION 

RQ$C$FORMAT$EXCEPTION 

HUMiAN INTERFACE 

DQSDELETE 

RQ$DELETE$FILE 

EXTENDED I/O SYSTEM 

DQ$DETACH . 

RQ$S$DELETE$CONNECTION 

EXTENDED I/O SYSTEM 


RQ$S$CLOSE 


DQSFREE 

RQ$DELETE$SEGMENT 

NUCLEUS 

V 


J 


UDI CALLS AND iRfIX 86 SYSTEM CALLS 


UDI CALLS 

iRMX 86 SYSTEM CALLS 

i SUBSYSTEMS 

DQ$GET$ARGUMENT 

RQ$C$GET$CHAR 

HUMAN INTERFACE 

DQ$GET$CONNECTION$STATUS 

RQ$S$6ET$C0NNECTI0N$STATUS 

EXTENDED I/O SYSTEM 


RQ$A$GET$FILE$STATUS 

BASIC I/O SYSTEM 

DQ$GET$EXCEPTION$HANDLER 

RQ$GET$EXCEPTION$HANDLER 

NUCLEUS 

DQ$GET$SIZE 

RQ$GET$SIZE 

NUCLEUS 

DQ$GET$SYSTEM$ID 

(NONE) 

(NONE) 

DQ$GET$TIME 

RQ$GET$TIME 

BASIC I/O SYSTEM 

DQSOPEN 

RQ$S$OPEN 

EXTENDED I/O SYSTEM 

DQSOVERLAY 

RQ$S$OVERLAY 

APPLICATION LOADER 

DQSREAD 

RQ$S$READ$MOVE 

EXTENDED I/O SYSTEM 

DQSRENAME 

RQ$S$RENAME$FILE 

EXTENDED I/O SYSTEM 

DQSSEEK 

RQ$S$SEEK 

EXTENDED I/O SYSTEM 

DQSSPECIAL 

RQ$S$SPECIAL 

EXTENDED I/O SYSTEM 

DQ$SWITCH$BUFFER 

RQ$SETS$PARSE$BUFFER 

HUr^N INTERFACE 

DQ$TRAP$EXCEPTION 

RQ$S$TRUNCATE$FILE 

EXTENDED I/O SYSTEM 

DQSWRITE 

KQ$S$WRITE$MOVE 

E)(TENDED I/O SYSTEM 
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EXAMPLE CALL TO REQUEST MEMORY 


DECLARE STATUS . WORD; 
DECLARE ARRAYJASE SELECTOR; 


ARRAY JASE = DQ$ALL0CATE(128, aSTATUS); 

• IF THE REQUEST FAILS THEN 

ARRAY JASE EQUALS 0FFFFH 
AND STATUS = E$MEM 
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ERROR REPORTING 

UDI PROCEDURES RETURN A CONDITION CODE THAT INDICATES THE RESULTS 
OF EXECUTING A UDI PROCEDURE. 

• YOU MUST CHECK THE CONDITION CODE AFTER EACH UDI CALL TO 
ENSURE PROPER RESULTS 

TABLE 6-2. iRMX 86 EXCEPTION CODES AND MNEMONICS 


HEX CODE 

MNEMONIC 

HEX CODE 

MNEMONIC 

0000 

E$OK 

0065 

E$EOF 

0001 

ESTIME 

0066 

E$FIXUP 

0002 

E$MEM 

• 

• 

• 

0067 

E$NO$LOADER$MEM 


(SEE COMPLETE LISTING IN RUN TIME SUPPORT MANUAL) 
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OTHER UDI FACTS 


INTERRUPT HANDLING 


PROGRAMS THAT RUN UNDER THE IRMX 86 OPERATING SYSTEM SHOULD 
USE iRMX 86 INTERRUPT MANAGEMENT TECHNIQUES TO HANDLE INTERRUPTS. 

• THE UDI LIBRARIES DO NOT INCLUDE INTERRUPT MANAGEMENT. 


REENTRANCY 


UDI LIBRARIES ARE FULLY REENTRANT WITH THE FOLLOWING RESTRICTIONS; 
f EACH JOB MUST HAVE ITS OWN COPY OF THE UDI INTERFACE LIBS. 


MULTITASKING 


• THE UDI LIBRARIES ARE FULLY COMPATIBLE WITH A 

MULTITASKING ENVIRONMENT. HOWEVER. THERE ARE NO UDI 
CALLS TO CREATE AND DELETE TASKS. 




LOGICAL NAMES 


THE UDI USES CERTAIN LOGICAL NAMES TO MEAN SPECIAL THINGS. 
FOR EXAMPLE. :LP: MEANS "LINE PRINTER". :CO: MEANS "CONSOLE 
OUTPUT". AND "Cl" MEANS "CONSOLE INPUT". 


REQUIREMENTS 


A UDI JOB MUST BE CONFIGURED IN YOUR SYSTEM WITH I.C.U.86. 
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APPENDIX 



APPENDIX A 
ALTER EDITOR 

• INSERTION 
t CORRECTING MISTAKES 


f ENDING THE EDITING SESSION 
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CURSOR CONTROL 



DELETING TEXT 


I CONTROL 


0 



CONTROL 


0 



CONTROL 


0 


DELETES CHARACTER AT CURSOR 


UNDO-RESTORES DELETED CHARACTERS 


THESE ALSO WORK DURING INSERTION 
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ADVANCED ALTER FEATURES 

f EDITING MULTIPLE FILES DURING 
ONE SESSION 

f BLOCK MOVES 


ALTER BUFFERS 



• SECONDARY BUFFER ALLOWS SEARCHING AND BORROWING FROM ANOTHER FILE 


• BLOCK BUFFER USED FOR MOVING OR DELETING BLOCKS OF TEXT 









ALTER INVOCATION 


- RUN ALTER INPUT FILE I^OTHER INPUT FILE] <CR> 

• OTHER INPUT FILE IS FILE TO BE EDITK IN SECONDARY BUFFER 
EXAMPLES : 

- RUN ALTER : FI: LABI. ASM <CR> 


- RUN ALTER :F1:LAB1.ASM>:F1:LAB1.LST <CR> 


- RUN ALTER ;F1:LAB1.ASM-LST <CR> 


ALTER MODES 


INSERT MODE 


<ESC> 


MAIN MENU 


FIRST LETTER 
OF COMMAND 

<ESC> OR fC 


<ESC> 


XCHANGE MODE 


<ESC> EXECUTES COMMAND & RETURNS TO MAIN MENU 
tc ABORTS COMMAND 



XCHANGE MODE 


• ALLOWS 'TYPING OVER' OF TEXT 


• <ESC> RETURNS ALTER TO MAIN COMMAND LEVEL 


CURSOR MOVEMENT AND PAGING 


- MOVES CURSOR TO END OF LINE 


- MOVES CURSOR TO BEGINNING OF LINE 


- PAGES DOWN 
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BLOCK — FOR COPYING TEXT 


KEYSTROKES 


HOME 

B 


SCREEN 

INTEL CORPORATION 
aNTEL CORPORATION 
aaTEL CORPORATION 
3NTEL CORPORATIONa 
INTEL CORPORATION 


• COPIES TEXT TO BLOCK BUFFER USING BEGIN & END MARKERS (3) 

• RETRIEVE TEXT WITH GET COMMAND 


GET — RETRIEVING THE BLOCK BUFFER 



• RETRIEVES BLOCK BUFFER TO CURRENT CURSOR POSITION 


NOTE: MAY ALSO BE USED TO 'GET' DISK FILES 
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FINDING A STRING 


KEYSTROKES 


F "STRING" ESC 


• SEARCHES FORWARD FOR FIRST OCCURENCE OF "STRING" AND 
MOVES CURSOR IF FOUND 


• -F COMMAND SEARCHES BACKWARDS 


REPLACING TEXT 


KEYSTROKES 


R "OLD STRING'1 ESC fNEW STRING" ESC 


f REPLACES FIRST OCCURENCE OF "OLD STRING" WITH "NEW STRING" AND 
MOVES CURSOR IF FOUND 


• ? REPLACE PROMPTS YOU: 

OK TO REPLACE? (Y OR INI) 
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REPEAT FUNCTION 


• OPTIONAL FACTOR THAT INDICATES THE NUMBER OF TIMES TO 
EXECUTE A COMMAND 


• PRECEDES ENTERING OF COMMAND LETTER 


• / - MEANS REPEAT FOREVER 


EXAMPLE: 

lOF "SAM" <ESC> 

FINDS TENTH OCCURENCE OF SAM 


JUMPING TO BEGINNING OR END OF FILE 


KEYSTROKES 


f JS MOVES CURSOR TO BEGINNING OF FILE 


• JE MOVES CURSOR TO END OF FILE 
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INSERTING CONTROL CHARACTERS 


KEYSTROKES 


H I "HEX VALUE" 1 ESC 


• INSERTS CONTROL CHARACTER AT CURRENT CURSOR POSITION AND 
DISPLAYS IT AS ? 


EXAMPLE: 

H I 0C ESC - INSERTS A FORM FEED CHARACTER 


DISPLAYING CONTROL CHARACTERS 


KEYSTROKES 


H 0 ESC 


DISPLAYS HEXADECIMAL VALUE OF CHARACTER AT CURRENT CURSOR POSITION 
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QUIT 


MENU PROMPT LME 


Abort Exit I nit Update Write 


SUBCOMMANDS; 


A - ABORT - ALL CHANGES LOST; RETURN TO OPERATING SYSTEM 

E - EXIT - RETURN TO OPERATING SYSTEM; FILE IS UPDATED 

I - INIT - RESTARTS EDITING SESSION; ALL CHANGES LOST 

U - UPDATE - UPDATES FILE; DOES NOT RETURN TO OPERATING SYSTEM 

W - WRITE - PROMPTS YOU FOR NEW FILE TO WRITE TO; DOES NOT 
RETURN TO OPERATING SYSTEM 


OTHER ALTER FEATURES 


• MACROS 


• DISK I/O 


• TAGS 


• ENVIRONMENT SETTINGS 
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PL/M IS A BLOCK STRUCTURED LANGUAGE 


MY$PR06: DO; 


DECLARATIONS 


• RESERVE SPACE IN MEMORY 
t GIVE A NAME TO THAT SPACE 


EXECUTABLE 

STATEMENTS 


• CAUSE WORK TO BE PERFORMED 


PL/M STATEMENT FORMAT 


• FREE FORMAT 


• ENDS WITH A SEMICOLON 


f COMMENTS 


- MAY BE USED WHEREVER A SPACE IS LEGAL 

- /* THIS IS A COMMENT */ 
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BASIC PL/M CONSTRUCTS 


• SEQUENTIAL 


• • CONDITIONAL 



f 

A=A+12; 


f 

B=B- 


- — 

— 



PL/M 

SAMPLE PROGRAM 


SERIES-III PL/M-86 VI. 0 COMPILATION OF MODULE SAMPLEl 
OBJECT MODULE PLACED IN :Fl rPROGl.OBJ 
COMPILER INVOKED BY: PLM86.86 ;Pl :PROGl . PLM 

/* THIS PROGRAM ADDS TWO NUMBERS */ 


SAMPLES 1: 
DO; 


DECLARE NUM$1 BYTE, 
NUM$2 BYTE, 
SUM BYTE; 

NUM$1 » 3; 

NUM$2 * 2; 

SUM = NUM$1 + NUM$2i 


6 1 END SAMPLES!; 

MODULE INFORMATION; 

CODE AREA SIZE « 0( 
CONSTANT AREA SIZE = 0( 
VARIABLE AREA SIZE = 0( 
MAXIMUM STACK SIZE = 0( 
15 LINES READ 
0 PROGRAM WARNINGS 
0 PROGRAM ERRORS 
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A VARIABLE HAS; 



NAME - FIXED THRUOUT PROGRAM 


CONTENTS - TRANSIENT .... 


VARIABLE DECLARATIONS 

f BEFORE ANY VARIABLE CAN BE USED IT MUST 
BE DEFINED IN A DECLARATION STATEMENT 

t VARIABLE DECLARATIONS 

- RESERVE SPACE IN MEMORY 

- ASSOCIATE AN IDENTIFIER WITH THAT SPACE 

- PRECEDE EXECUTABLE STATEMENTS 


PROG: DO; 


DECLARE SPOT BYTE; 
SPOT =5; 


MEMORY 


SPOT 00000101 
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• SIMPLIFY PROGRAM UPDATES: 

DECLARE BUFFER$SIZE LITERALLY '256'; 
DECLARE COUNT WORD; 

DECLARE BUFFER(BUFFER$SIZE) BYTE; 


COUNT = BUFFER$SIZE;/*SAME AS: COUNT =256;*/ 


• IMPROVE DOCUMENTATION; 

DECLARE SPACE LITERALLY '20H'; 
DECLARE CR LITERALLY '0DH'; 

DECLARE LF LITERALLY '0AH'; 



• EXPRESSIONS WITH OPERATORS OF EQUAL PRECEDENCE ARE EVALUATED 
LEFT TO RIGHT 
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ARITHMETIC EXPRESSION SUMMARY 


VARIABLE TYPE 

PL/M-80 

PL/M-86 

BYTE AND 
ADDRESS 

BYTE AND 
WORD 


INTEGER 

REAL 


ARITHMETIC 

OPERATION 


RESULT 


UNSIGNED 

1 BYTE. 1 BYTE 


1 BYTE. 2 BYTE 


2 BYTE. 2 BYTE 

UNSIGNED 

1 DYTE.i! .BYTES 

2 BYTE.^l BYTES 
BYTE.^; BYTES 

SIGNED 

INTEGER. INTEGEF 

FLOATING 

POINT 

REAL. REAL 


+^-.*./.MOD 

1 BYTE 

2 BYTE 

+.-.*. /.MOD 

2 BYTE 

+.-.*./.MOD 

2 BYTE 

/.MOD 

4 BYTES 
^ BYTES 
^ BYTES 

+.-.*./.riOD 

INTEGER 

+.-.*./ 

REAL 


LOGICAL AND RELATIONAL EXPRESSION SUMMARY 


VARIABLE TYPE 


PL/M-80 


BYTE AND 
ADDRESS 


PL/M-86 


BYTE AND 
WORD 


INTEGER 


OPERAND 

TYPE 


1 BYTE. 1 BYTE 

1 BYTE. 2 BYTE 

2 BYTE. 2 BYTE 


1 BYTE. 4 BYTES 

2 BYTES, a BYTES 
^ BYTES. ^ BYTES 

INTEGER. INTEGER 


RELATIONAL 

RESULT 


1 BYTE 
1 BYTE 
1 BYTE 


LOGICAL 

RESULT 


1 BYTE 

2 BYTE 
2 BYTE 


^ BYTES 
;i T^vjrs 
BYTES 


REAL. REAL 


:llegal 
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PORT INPUT AND OUTPUT 

DATA IS "READ" FROM OR "WRITTEN" TO SPECIFIED PORT 


PL/M 80 

BYTE READ 
WRITTEN 


PL/M 86 


1 BYTE READ OR 
WRITTEN 

<VARIABLE> = INPUT (<PORT$EXPR »j 

OUTPUT «PORT$EXPR » = <VARIABLE$EXPR> 

CONSTANT ' 


<VARIABLE> = INI-IORD «PORT$EXPR»; 

2 BYTES READ OR 
WRITTEN 

OUTWORD«PORT$EXPR» = <VARIABLE$EXPR> 

CONSTANT ' 



PL/M-80 

PL/M-86 

• MUST BE A 

0 CAN BE A 

NUMBER OR A 

NUMBER^ CONSTANT 

CONSTANT 

EXPRESSION, OR 

EXPRESSION 

EXPRESSION 

• 0< portSexpr 

t 0< PORT$EXPR< 

<255 

65535 i 




DO WHILE BLOCKS 


[<LABELNAME> :] DO WHILE <EXPRESS10N> j 
[<STATEMENT>] ; 


END [<LABELNAME>I ; 


<EXPR> 


<STMT> 

<STMT> 


• STATEMENTS EXECUTE AS LONG AS < EXPRESSION> EVALUATES TO A NUMBER WITH 
BIT 0=1 
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ITERATIVE 'DO' BLOCKS 


DO <COUNTER$VARIABLE> = <STARTEXP>TO<LIMITEXP> (BY<STEPEXP> I, 
[<STATEMENT> ]; ... I 


WHERE 

<COUNTER$VARIABLE> IS A 1 BYTE OR 2 BYTE VARIABLE 

<STARTEXP> . < LIMITEXP> AND <STEPEXP> / 

ARE EXPRESSIONS ^ 


COUNT!. 
LIMIT 
0 / 


• STATEMENTS WITHIN AN ITERATIVE DO BLOCK ARE EXECUTED REPEATEDLY 


IF.. THEN 

THE CONDITIONAL STATEMENT TESTS AN EXPRESSION FOR TRUE OR FALSE 
AND CAUSES CODE TO BE EXECUTED OR BYPASSED ACCORDINGLY. 


IF <EXPRESS10N> THEN 
<STATEMENT> 
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THE 'DO CASE' 


[<LABELNAME> ;]D0 CASE <EXPRESSION> J 


<STATEMENT> 

<STATEMENT> 


/•executed when expression = */ 

/• EXECUTED WHEN EXPRESSION = 1 */ 


[<CTATEMENT>] 
END [<■ LABELNAME>] ; 


/* EXECUTED WHEN EXPRESSION “ N */ 


inPQRTA MT: NO RANGE CHECK IS PERFORMED ON THE VALUE OF THE EXPRESSION 
AFTER IT IS COMPUTED. IF THE VALUE COMPUTED IS GREATER THAN THE 
NUMBER OF 'BASIC$STATEMENTS', THE PROGRAM CRASHES. 
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ARRAYS CAN BE USED TO MANIPULATE 
GROUPS OF RELATED DATA ITEMS 


SORTING OFFICE I 



• AN ARRAY OF BOXES FOR EACH STREET 

• EACH ARRAY HAS A NAME 

• REFER TO BOX FOR NO. A HIGH STREET: 

mm) 

• ALL MEMBERS OF AN ARRAY MUST BE OF 
THE SAME TYPE 


DECLARE VICTOR I A (120) BYTE; 
DECLARE HIGH (81) BYTE; 




STORAGE OF DATA INPUT FROM TEMPERATURE SENSOR 



DATA$IN: 



.DO; 

DECLARE READY LITERALLY '01'; 
DECLARE TEMP$BUFFER(256) BYTE; 
DECLARE TEMP$BUFFER$PTR BYTE; 




DO TEMP$BUFFER$PTR = 0 TO 255; 




DO WHILE INPUT ( 4 )<>READY; 
END; 



END; 

TEMP$BUFFER(TEMP$BUFFER$PTR) = INPUT ( 8 ); 
END; 





J 
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STRUCTURES 


• LOGICAL AND PHYSICAL GROUPS OF DISSIMILIAR, REUTED DATA ITEMS 

• A STRUCTURE MAY CONTAIN DATA ITEMS OF DIFFERENT TYPES 


DECLARE AIRPLANE STRUCTURE( 
SPEED BYTE, 
ALTITUDE WORD)j 
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ARRAY OF STRUCTURES 


DECLARE AIRPLANE (5) STRUCTURE ( 
SPEED BYTE, 



AIRPLANE (0) 


AIRPLANE (1) 


AIRPLANE (4) 


STRUCTURE WITH AN ARRAY AS AN ELEMENT 


DECLARE AIRPLANE STRUCTURE( 
SPEED BYTE, 

ALTITUDE WORD, 
ENGINE BYTE)j 


AI 

AI 

AI 

AI 

AI 

AI 


RPLANE. SPEED » 

RPLANE. ALTITUDE * 

RPLANE, ENG I NE(0)“^ 
RPLANE. ENGINE(I) — * 

RPLANE. ENGINE(2) * 

RPLANE. ENGINE(3) — ^ 




PROCEDURE DECLARATION 


PROCEDURE HEADING 


DECLARATION PART 


EXECUTABLE PART 


MODULE*NAME: 

DO; 

KDECURAT10NiSTATEMENTS> 1 

PROCEDURESNAME : PROCEDURE ; 

KDECLARATION$STATEMENT> ] 
<EXECUTABLE$STATEMENT> 
<END l<PROCEDURESNAME> ] 

[ <DECLARATION$STATEMENTS> 1 
KEXECUTABLE$STATEMENTS> 1 


PARAf'.ETERLESS PROCEDURE 
main: DO; 

DECLARE (result^ opI, op2. answer) BYTE: 


sum: PROCEDURE; 

RESULT = opI + op2; 
END SUM; 

OpI = 

op2 = 5; 

CALL sum; 

ANSWER = result; 

END MAIN; 


/* procedure DEFINITION *' 


/* START OF MAIN */ 


/• PROCEDURE INVOCATION */ 


• PROCEDURE ACCESSES 
GLOBAL VARIABLES 
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PROCEDURE WITH PARAMETERS 


main: DO; 

DECLARE (x> y> answerI) BYTE; 

DECLARE (a> b> answer2) BYTE; 

DECLARE RESULT BYTE; 

sum: PROCEDURE (op1> op2); /* procedure definition */ 

DECLARE (opl, op2) BYTE; 
result = opI + oi?2; 

END sum; 

CALL sum(x> y); /* procedure invocation */ 

answerI = .result; 

CALL SUM (a-5,b-2); /* procedure invocation */ 

ANSWER2 = result; 

END main; 


• TWO INPUT PARAMETERS 

• PROCEDURE OUTPUT IS RETURNED IN A GLOBAL VARIABLE 


TYPED PROCEDURES 


A SINGLE VALUE IS RETURNED 


MAIN: DO; 

DECLARE (X.Y.ANSWER) BYTE: 


SUM: PROCEDURE (OPI, 0P2) BYTE; 
DECLARE (OPI. 0P2) BYTE; 


/* PROCEDURE DEFINITION V 


RETURN OPI + 0P2; 
END SUM; 

X = 3; 

Y = 2; 

ANSWER = SUM (X.Y); 


/* PROCEDURE INVOCATION V 


END MAIN; 
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BUFF IS "GLOBAL" 


VARIABLES: GLOBAL vs. LOCAL 


DECLARE BUFFQ28) BYTE: 


"I" AND PORT$IN 
ARE "LOCAL" TO 
FILLSBUFFER 


CALL FILL$BUFFER; 
END; 


PROCEDURE; 


DECLARE I BYTE; 

PORTS IN: 

PROCEDURE BYTE; 


END; 

BUFF(I)=PORT$IN; 

END; 



SCOPE OF VARIABLES 


• THE SCOPE OF A VARIABLE IS THE FULL LENGTH OF THE BLOCK. UNLESS IT 
IS REDECLARED WITHIN A NESTED BLOCK. 

• TO DETERMINE IF A VARIABLE/LABEL CAN BE USED IN A BLOCK: 

1) IF IT IS NOT DECLARED IN THE BLOCK. GO TO THE NEXT OUTER BLOCK. 

2) IF DEFINED. THE SCOPE IS SET. ELSE REPEAT 1) AND 2). 

3) IF REACH THE OUTER MOST BLOCK WITHOUT ENCOUNTERING THE 
DECLARATION. THE VARIABLE/LABEL CANNOT BE USED. 


C: \ x.R.o 
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SYNTAX 


• DECLARE <VAR I ABLE$NAME> BASED <P01NTER$VARIABLE> 

^BYTE ^ 

WORD 

Q<ARRAY$C0NSTANT> );] / INTEGER \ ; 

REAL 

.STRUCTURE. 


PROCEDURE (OPl PTR. 0P2 PTR, RSLT PTR); 


DECLARE OPl-PTR POINTER. 

0P2_PTR POINTER. 

RSLT PTR POINTER: 


/* ADDRESS FOR PL/M-80 V 


DECLARE OPl BASED OPl PTR (6) BYTE. 


BASED VARIABLE BASE DIMENSION SPECIFIER OF BASED VARIABLE 


OP2 BASED OPl_PTR (6) BYTE. 
RESULT BASED RSLT PTR (6) BYTE; 


PROGRAM TO SUM TWO ARRAYS USING BASED VARIABLES 
ARRAYSSUM: DO; 

DECLARE ANSWER (6) BYTE. TOTAL (8) BYTE. 

X (6) BYTE. A (8) BYTE. 

Y (6) BYTE. B (8) BYTE; 

SUM: PROCEDURE (OPl_PTR. 0P2_PTR. RSLT_PTR. ARRAYSIZE); 

DECLARE OPl.PTR POINTER. 

0P2_PTR POINTER. 

RSLT_PTR POINTER. /* ADDRESS FOR PL/M-80 */ 

ARRAYSIZE BYTE; 


DECLARE OPl BASED OPl.PTR (1) BYTE. 

OP2 BASED 0P2_PTR (1) BYTE. 
RESULT BASED RSLT.PTR (1) BYTE; 

DECLARE I BYTE; 

DO I = 0 TO ARRAYSIZE; 

RESULT (I) = OPKI) + 0P2(I) 

END; 

END SUM; 

CALL SUMOX. 3Y. aANSWER. UST(ANSWER) ); 
CALL SUM OA, aB. aTOTAL. LAST(TOTAD); 
END ARRAY$SUM; 


NOTE: IN PL/M-80. USE 
INSTEAD OF "a". 
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A "BASED VARIABLE" IS A PROCEDURE'S MOVABLE TEMPLATE FOR 
A DATA STRUCTURE DECLARED IN A CALLING PROGRAM. 


MAIN: 

DO; 

DECLARE ARRAY$1 (6) BYTE. 

ARRAY$2 (A) BYTE; 

ARRAY$HANDLER : PROCEDURE ( ARRAY$PTR ) ; 

DECLARE ARRAY$PTR POINTER: 

DECURE BLOCK BASED ARRAY$PTR (1) BYTE; 

/* EXECUTABLE STATEMENTS V 

END ARRAYIHANDLER: 


CALL ARRAY$HANDLER (aARRAY$l). 

CALL ARRAYIHANDLER OARRAY$2); 
END MAIN; 


C SOME PRIMARY CONTROL NAMES ^ 

NOPRINT / PRINT (SOURCESFILE.LST)* 

DESTINATION OF LISTING 

SYMBOLS / NOSYMBOLS* 

GENERATE SYMBOL TABLE LISTING 

XREF / NOXREF* 

GENERATE CROSS REFERENCE LIST 

DEBUG / NODEBUG* 

RETAINS SYMBOL TABLE 

PL/M-86 ONLY 

( 0 MINIMAL CODE OPTIMIZATION 


1: CONSTANT & COMMON EXPRESSIONS 

OPTIMIZE (0 / 1* / 2 / 3) 

2: #1 PLUS LOCAL CODE OPTIMIZATION 

1 

^ 3: #2 PLUS FURTHER OPTIMIZATION 

ROM/RAM* 

PLACEMENT OF CONSTANTS IN CODE SEGMENT 

TYPE*/NO TYPE 


SMALL* /COMPACT / MEDIUM / URGE 

(SEE P. 8-6) 

* DEFAULT CONDITION 



J 
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PL/M COMPILER OPERATION 


COMMAND SYNTAX: 

PLM86 

[:<DEVICE>3 PLM80 <SOURCE$FILE> [<CONTROLS>J 

<CONTROLS> IS A SEQUENCE OF EITHER 

■ <PRIMARY$CONTROLS> WHICH MUST OCCUR BEFORE SOURCE CODE 
<GENERAL$CONTROLS> WHICH MAY OCCUR ANYWHERE (INVOCATION 
OR IMBEDDED WITHIN THE SOURCE CODE.) 


SOME GENERAL CONTROL NAMES 


LIST* / NOLIST 
CODE / NOCODE* 

EJECT / -* 

INCLUDE / -* 

OVERFLOW / NOOVERFLOW* (PL/M-86 ONLY) 


SUSPEND / RESUME LISTING 
GENERATE OBJECT CODE INTERLIST 
GENERATE PAGE EJECT 
INCLUDE CONTENTS OF ANOTHER FILE 
INTEGER OVERFLOW DETECT CODE 
(REQUIRES USER SUPPLIED TYPE A 
INTERRUPT SERVICE PROCEDURE. 
DISCUSSED IN CH. 16) 


DEFAULT 
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COMPILER CONTROL USAGE 


> PLM86 :F1:ALICE.SRC DEBUG SYMBOLS 0PTIMIZE(2) 


IN THE SOURCE FILE WE HAVE THE FOLLOWING: 


'$' MUST 
APPEAR IN 
COLUMN 1 


BIG$TIME: DO; 

$INCLUDE (:F1:PREAMB.LITV 


SEJECT 


-COMPILATION FAILS 
IF :FI: NOT READY 
OR IF :FI: PREAMB.LIT 
DOES NOT EXIST 


DECLARE CAROL BYTE; 


$EJECT 


SNOLIST 


[1< EXECUTABLE$STATEMENTS>D 


• PL/M-86: SIZE CONTROL SWITCH 

ALLOCATION OF MEMORY AND THE WAY IN WHICH LOCATIONS ARE REFERENCED BY A 
PROGRAM IS DETERMINED BY THE SIZE CONTROL SWITCH. 

1. 'SMALL' - FOR PROGRAMS WITH LESS THAN 6AK BYTES OF CODE AND LESS 
THAN 6AK BYTES OF DATA. (MAXIMUM OF 128K BYTES.) 


2. 'COMPACT' - FOR PROGRAMS WITH A MAXIMUM OF 64K BYTES EACH OF CODE. 
DATA. AND STACK. 


3. 'MEDIUM' - FOR PROGRAMS WITH MORE THAN 64K BYTES OF CODE AND LESS 
THAN 64K BYTES OF DATA. 


4. 'LARGE' - FOR PROGRAMS WITH MORE THAN 64K BYTES OF CODE AND MORE THAN 
64K BYTES OF DATA. 


FOR GREATEST EFFICIENCY. USE THE SMALL CASE WHEN POSSIBLE. UPGRADED PL/M-80 
PROGRAMS MiM USE THE 'SMALL' CASE. 
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APPENDIX C 




WHY THE NEED FOR A BOOTSTRAP LOADER? 

• MAINTENANCE COSTS GREATLY REDUCED 

- MINIMIZE THE NEED TO MANUFACTURE ROM CHIPS 

- SOFWARE UPGRADES AND BUG FIXES ARE EASILY INSTALLED 
AND DELIVERED 



'SOFTWAREi 



r~ 


FUNCTION AND CONTROLLERS 



• THE BOOTSTRAP LOADER FUNCTION 



- LOAD THE RMX86 O.S AND APPLICATION SOFWARE FROM 
SECONDARY STORAGE INTO RAM 



• SECONDARY STORAGE SUPPORT 



- THE RMX86 PRODUCT INCLUDE BOOTSTRAP LOADER DEVICE 
DRIVERS FOR THE FOLLOWING CONTROLLERS: 



1) 

I SBC 20A 



2) 

I SBC 208 



3) 

I SBC 206 



^) 

I SBC 215 



5) 

I SBC 218 



6) 

I SBC 254 
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STAGES 


• THERE ARE TWO PARTS TO THE APPLICATION LOADER 
- THE FIRST STAGE AND THE SECOND STAGE 



PASSES. 



• RUNS UPON SYSTEM RESET 

• FINDS DEVICE TO LOAD 
FROM 

• LOADS PART OF 2ND 
STAGE AND TRANSFERS 
CONTROL 



PASSES 


CONTRO 



• FINISHES LOADING 
ITSELF 

• FINDS FILE TO LOAD 
FROM 

• LOADS FILE AND TRANSFERS 
CONTROL 


THE SECOND STAGE 

• A VOLUME MAY BE FORMATTED WITH THE HUMAN INTERFACE OR 
THE FILES UTILITIES. 

• THE FORMATTING PROCESS WILL PLACE THE SECOND STAGE ON 
THE VOLUME WITH NO EFFORT ON YOUR PART. 


• THE SECOND STAGE IS 6K OF LTL CODE. 
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THE FIRST STAGE 


a THE FIRST STAGE CONSISTS OF TWO PARTS 
a THE FIRST STAGE RESIDES IN ROM 

a DEVICE DRIVER SOFTWARE (PART I) 

- SIZE DEPENDS ON HOW MANY DEVICE DRIVERS YOU CHOOSE 
TO INCLUDE. (EACH DRIVER 300 TO 500 BYTES) 

a BOOT LOADER CORE (PART 2) 

- THIS PART LOADS THE 2ND STAGE 

- SIZE DEPENDS ON HOW MANY OPTIONS YOU CHOOSE. 

(SIZE 100 TO 500 BYTES) 



FIRST STAGE OPTIONS 


a THE LOCATION OF THE FIRST STAGE 

a THE LOCATION WHERE THE FIRST STAGE LOADS THE SECOND STAGE 

- (USUALLY IN THE FREE SPACE OF THE FINAL SYSTEM TO BE LOADED) 

a METHOD TO BE USED FOR DEVICE SELECTION 

- NO SELECTION 

- AUTO SELECTION 

- MANUAL SELECTION 

a METHOD TO BE USED FOR FILE SELECTION 

- LOADING A DEFAULT FILE NAME 

- ALLOWING THE END USER TO SPECIFY A FILE NAME 


I J 
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DEVICE SELfCTION 


NO SELECTION 

- BOOTSTRAP LOADER ALWAYS USES SAME DEVICE 

- IF DEVICE IS NOT READY. LOADER TERMINATES 

AUTO DEVICE SELECTION 

- YOU PROVIDE A LIST OF DEVICES 

- THE LOADER CYCLES THROUGH THE LIST UNTIL IT 
FINDS A READY DEVICE 

MANUAL DEVICE SELECTION 

- THE LOADER PROMPTS THE USER AT THE TERMINAL (*) 

- THE USER ENTERS A DEVICE NAME (E.G. :F0:) 

- IF NAME IS NOT FOUND THEN LOADER SWITCHES TO AUTO 
DEVICE SELECTION 


FILE SELECTION 

• THE LOADABLE FILE MUST BE A NAMED FILE 

t LOADING A DEFAULT FILE 

- THE DEFAULT FILE IS (/SYSTEM/RMX86) 

• SPECIFYING A FILE NAME 

- DEVICE DELECTION MUST BE MANUAL 

- (E.G. :YES:LIFE/IS/HARD/IN/THE/FAST/LANE) 


c- 



PROBLEMS 


WHAT IF: 


• I AM NOT USING ONE OF THE BOOTSTRAP DEVICE 
DRIVERS SUPPLED WITH THE RMX86 PRODUCT? 

• I DO NOT HAVE THE STANDARD 957B "TERMINAL" SUPPORT? 



WAIT— DON'T DO IT ! ! ! 


WRITING YOUR OWN DEVICE DRIVER 

• A DEVICE DRIVER FOR THE BOOTSTRAP LOADER CONSISTS OF 
TWO PROCEDURES: 

- DEVICE$INIT AND DEVICE$READ 

• THE PROCEDURES MUST BE WRITTEN IN THE PLM86 LARGE MODEL. 


• THE RMX86 LOADER REFERENCE MANUAL SUPPLIES MORE SPECIFIC 
INFORMATION ABOUT THESE PROCEDURES. 
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CUSTOM TERMINAL SUPPORT 

0 THERE IS INTEL PROVIDED SOURCE CODE (MODIFIABLE TO YOUR 
NEEDS) FOR TERMINAL COMMUNICATION SUPPORT. 


• YOU CAN ALWAYS WRITE YOUR OWN CODE. 



0 I CAN CHOOSE ANY FILE NAME TO BE LOADED? T OR F 

0 WHAT IS THE MAX NUMBER OF DEVICES I CAN SPECIFY 
IN AUTO SELECTION? 

0 WHAT ARE POSSIBLE ERROR CAUSES IF BOOTSTRAP LOADER 
LOOPS IN 2ND STAGE? 


s. 





HINT — LOOK IN THE LOADER MANUAL ! ! ! 
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